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PERFECTION 
PERFECTION PLUS 


Perfection Is the finest word processor available for any 
computer. We have received dozens of letters from 
happy users saying Just this... and all of these letters 
were unsolicited. "Superb" was used most often. 


Perfection manages to achleve all the sophistication of 
the most complex PC word processors while still using a 
user Interface as friendly as Quill's. Perfection has a dual 
system of user control: menus while you are familiarising 
yourself with the program, and direct commands for the 
time when you feel ready for more adventurous things. 
The two systems can be used interchangeably and even 
simultaneously. Even more exciting - both systems are 
Iterative. In case you don't understand what this means, 
let us give you an example: suppose you wished to move 
a block of text using the menus. You would choose Block 
Move (yes, it is right in the first menu) and the screen 
would then tell you to move your cursor to the start of 
the block. On most word processors you would have to 
navigate manually to this position: Indeed, on many of 
them (Quill included) only a subset of the normal 
navigation commands would be available. On Perfection, 
not only can you use all the manual navigation 
commands (viz all 28 permutations of CTRL, ALT, SHIFT 
and the arrow keys!) but in addition you can use direct 
commands like GoTo Line or Page or any of eight 
markers. Even more amazingly, you can use Search 
(either as a direct command or from the menus) even 
though you are already ‘'within' a menu option. 


Perfection has about 200 commands, but the layout of 
menus and the choice of keys for the direct commands 
makes It very easy to master. Though a 100+ page 
manual is provided (with all the important bits right at 
the front), you should only need to consult it for 
specialised operations like macros. 


Even If speed is not particularly important to you, we 
assure you that Perfection's lightning performance will 
enable you to use the word processor in sensible ways 
that you would not have dreamed possible before. For 
example, scrolling 100 pages or so is accomplished so 
quickly using the normal navigation commands that you 
do not need to bother using a menu option to do the 
move. Spelichecking, assuming you have Perfection Plus, 
Is accomplished virtually Instantly: to spellcheck this 
whole ad (all the pages) would take under 1.5 seconds... 
Searching (you can switch case sensitivity, as well as 
equivalences between tabs, soft spaces and hard spaces) 
is at the rate of about 100 A4 pages per second. 


Moving from one word processor to another Is usually 
very traumatic. With Perfection, this will not be the case. 
Not only can Perfection read in Quill doc and _exp files 
directly (you do not even need to tell it they are Quill 
files!) but it can make direct and immediate use of your 
existing Quill printer driver. File re-export is also possible. 


Perfection Is truly WYSIWYG: this means that bold 
appears bold on screen, italics appear as italics, 
underlined as underlined, and so on. Of course, your 
printer may have functions we do not know about 
(upside down?). To deal with these, Perfection provides a 
number of on-screen shaded strips: these can be 
attached to any printer function you wish, and will not 
upset justification as a translate would. Of course, 
translates are provided as welll 


A variety of statistics on the document being processed 
are available: some of them are on view all the time, the 
rest can be toggled to instantly. Not only Is there a word 
count, but also page, line, character and special 
character (like Superscript Off) counts. There are also a 
dozen status Indicators, letting you know whether you 
are in Insert or Overwrite mode, whether a block Is 
defined, whether interactive spelichecking is enabled 
etc. Current line (from top as well as within page) and 
column positions and character codes are also available. 


A terrific feature of Perfection is the dual screen mode. 
You can view one part of the document while editing 
another. The sizes of the two windows are themselves 
adjustable, both In real-time or via the configurator. We 
should devote more space to the configurator: however, 
it must suffice to say that everything that could be 
dynamically set within Perfection may also be preset 
with the configurator. The configurator can, for 
example, allow you to select any of 256 colours for any 
of a dozen parameters (like paper colour, border colour, 
status window ink and paper colour etc). 


Perfection is fully multitasking without need for any 
external accessory: however, if you already use QPAC or 
Taskmaster or similar and are happy, you may go on 
doing so. 


There Is absolutely no way that we can prepare you for 
the quality 'feel' of Perfection. We have a great deal of 
experience using PC word processors costing many 
hundreds of pounds: with absolutely no exception, 
Perfection is far easier to use and master. 


So If you thought Perfection was unattainable, you have 
a very pleasant surprise coming to youl 


LIGHTNING SPECIAL EDITION 
LIGHTNING 


These programs accelerate QL operation by up to 10x (2x 
—4x Is typical) without having any adverse effect 
whatsoever on compatibility or anything else. Lightning 
SE is typically 40% faster than the standard version. This 
acceleration Is totally independent of, and in addition to, 
any speed-up obtained by hardware means. So If you 
have Gold Card, your need for Lightning SE is just the 
same as If you had only an unexpanded QL - Lightning 
SE will accelerate both by the same ratio. 


The Lightning programs achieve their acceleration by 


automatically paging out sections of the QL's operating 
system and replacing these with optimal, concise code 
written by us. 


Lightning installation Is a completely automatic and one- 
off: no knowledge of computing or programming is 
required. Once installed, Lightning can be completely 
forgotten about - you will soon get used to the superb 
speed! Knob twiddlers are catered for too. 


Lightning technology is not built in to any of our other 
programs. Perfection users (as well as users of all other 
QL software) should therefore use Lightning all the time. 


In summary: if you do not have Lightning, you are 
wrong. Buy this one ARST OF ALL! 


PROFESSIONAL PUBLISHER 


The Professional In Professional Publisher is 
Professional Publisher supplied with a generous 
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Professional Publisher is by 
far the best DTP program 
for the QL. It Is fully com- 
patible with Perfection, 
Editor, Quill, Eye-Q & the 
ASCIl editors. It allows you 
to both create and import 
both text and graphics. 
Text can be 'poured' Into 
boxes of any shape , size 
and number, automatically 
maintaining Justification 
and hyphenation settings. 
So flowing text around 
graphics is a doddle. 


Publisher's features — we 
would end up filling half 
the magazine! We will 
concentrate on just a few 
‘points': Professional 
Publisher is extremely pre- 
cise, performing all its 
computations accurate to 
a small fraction of a mil- 
limetre. All its features can 
be preset by you using its 
configurator, ruling out 
the need for repetitive key 
strokes. 

The program Is extraordi- 
narily versatile while re- 
maining Intuitive In its 
user interface. Buy it! 


PROFESSIONAL PUBLISHER 
TOOLBOXES 


Toolbox | Is an excellent collection of high definition 
fonts, clip art and utility programs for Professional 
Publisher. While the fonts supplied with Professional 
Publisher are excellent, many users will feel the need for 
a wider range of typefaces and styles. 


Toolbox II starts where Toolbox | leaves off, providing an 
even better - and different — font collection. 


The two Toolboxes complement each other and are 
available together at a special price. 


FONT ENLARGER 
GRAFIX 


Font Enlarger does exactly what you would expect it to 
from its name. While Professional Publisher Is also 
capable of enlarging fonts, it does them ‘on the fly’ and 
consequently Is not able to remove the jaggedness 
caused by magnification. Font Enlarger is much cleverer, 
and enhances detail without any step effect. 


While the built-in printer driver for Professional 
Publisher is excellent with 9-pin printers, it is not optimal 
with 24-pin or laser printers. Grafix is. 
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EYE-Q 
ULTRAPRINT 


Eye-Q Is the finest graphics program for the QL. While 
there may be other graphics programs with a few more 
features, no other program comes anywhere close to 
Eye-Q in sheer enjoyability. Eye-Q develops a pleasurable 
tactile relationship with you, and makes you feel like an 
artist (even if you aren't). Eye-Q graphics can be read In 
by Professional Publisher, and the latter's pages can be 
exported to Eye-Q (using Toolbox |). Everything in Eye-Q 
is menu-driven and there is context-sensitive help. 


While Eye-Q has Its own printer driver, Ultraprint allows 
you 22 distinct styles/sizes of printer output. The 
reasoning is that the scale of gradation suitable for 
pictures is probably unsuitable for text or line drawings. 


PC CONQUEROR 
SOLUTION 


PC Conqueror makes your QL Into a PC-compatible 
machine,automatically. It does this by software means 
only, so there are no screws to undo or wires to fiddle 
with. Your QL stays a QL too. 


Why, might you ask, should you wish to make your QL 
into a PC-compatible? The reason is simple: you may wish 
to run the same programs at home as you do at work. 
Alternatively, you may wish to tap Into the vast 
storehouse of PC software of every type and description 
you could imagine. 


Using PC Conqueror could not be easier. Just boot up your 
machine with the PC Conqueror disk In floppy 1 and 
within 10 seconds your QL will be transformed into a PC 
that is just waiting to be switched on. From this point on 
you will do exactly the same as you would if you were 
running a ‘real’ PC — this means putting a DOS disk (any 
version) into one of your drives and pressing a key. If you 
do not already have legal access to a copy of DOS, we can 
provide you with one at reasonable cost (see our price 
list). 


PC Conqueror runs as fast as it Is possible for a PC 
emulator to run: we have used all our skills to make it 
work quickly. Of course, you can make the emulation 
must faster by using Gold Card and Lightning SE. With 
this combination, you should get speed noticeably better 
than that of a PC XT... 


PC Conqueror allows you to fine-tune the operating 
environment of the PC in order to improve performance. 
If you get a hard disk or other high capacity floppy 
system, you can utilise part or all of it as a PC hard disk. 


PC Conqueror occupies under 80K and leaves 667K free 
for DOS when run on a Trump Card. This is more than you 
will get on a ‘real’ PC. 


Solution does what Conqueror does but Is about half as 
fast and is not quite as compatible. 


SPELLCHECKER 
MEGA DICTIONARY 


Spelichecker is what makes Perfection into Perfection 
Plus. We have made It available as a separate item for two 
reasons: (a) to allow Perfection owners to add It later 
(b) to allow users of other word processors to benefit 
from the very best in spelichecking technology. 


Spellchecker Is supplied complete with three dictionaries 
of differing sizes as well as a system for bullding, 
reviewing and maintaining user dictionaries. 


Spelichecker's ultimate accessory Is the Mega Dictionary, 
which gives the user a vocabulary of over 350,000 words! 


3D PRECISION CAD SYSTEM 


This program allows you to manipulate shapes and 
figures In 2D and 3D at a speed that will leave you 
breathless. Irrespective of whether your interest is in CAD, 
in animation or in just having fun, this program should 
not be missed. You can output to plotters directly from It, 
or alternatively create graphics screens to be manipulated 
and output by Eye-Q, Ultraprint or Professional Publisher. 


SUPER SPRITE GENERATOR 


SSG moves things about the screen very fast and very 
smoothly, without flicker. Sprites can have up to 16 frames. 
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TROUBLESHOOTER 


Archive modification, big dictionaries and yet more disk situations. And where have all 
the grumbles gone? It must be the holiday season. 


QOL SCENE 


C68 source code now public ... translators wanted ... Sir Clive’s bike briefly baulked ... 
optical character non-recognition 


POOLING RESOURCES 


The first thing Stan Canton did when he bought his QL was to build it a home of its 
own. Since then it has been assisting him with his businesses and software 
development, including a Football Pools Forecast program. 


SOFTWARE FILE - COWO QTOP 


Dell Allan runs through the latest update on Cowo’s QTop front end for QL and Thor 
computers. 


OPEN CHANNEL 
ONLY FOLLOWING ORDERS 


Following the first part in July QL World, P Warne shows how Abacus can keep track 
of bank payments that do not occur regularly every month. 


USER REPORT - QDESIGN 


QDesign is an advanced graphics and design program from Jochen Merz, which 
utilises the QJump Pointer Environment. A F Wilson has been using QDesign 1 for 
about a year. 


THE NEW USER GUIDE - part 18 


Section Eighteen comes with a surprise - the contents of Section Sixteen. These 
should have been in the July issue of QL World. Section Eighteen appeared in 
Section Seventeen last month. We hope you understand. 


DIY TOOLKIT 


Simon Goodwin’s VOCAB generates formatted reports on the vocabulary of your 
SuperBasic interpreter. 


ONE MAN’S SYSTEM 


David McCullagh uses Abacus to keep his Dublin swimming team afloat. As well as 
tracking the swimmers, it keeps track of the accounts as well. 


ARCHIVE ANSWERS - BIBLIOGRAPH 


Robin Stevenson’s method for using Archive to structure a set of bibliographical 
references can also be applied to other collections. 


SYSTEMATIC MACHINE CODE PROGRAMMING Part 9 


TROUBLE SHOOTER 


TROUBLE 


Bryan Davies gets a B in his bonnet. The editor says: “Oh, K.” 


ardly had the August Trouble 
shooter gone off to the maga 
zine than my comments about 
not using Archive started to 
seemless funny. The time had 
come to try to do something with a set of 
accounting routines written in the Archive 
language, years ago, and it was soon clear 
that this was no easy task. Not to put too 
fine a point on it, | gave up, but only after 
several days of struggle. Maybe the origi- 
nal programmer wanted to keep the code 
obscure in order to protect his commercial 
interest, but that probably wasn’t the main 
reason for my difficulty in following the 
thread. 

Weall have our trouble trying to think 
straight. We usually find it easier to get 
stuck straight in to the job, as we see first 
see it. Only later do we realise the agonies 
created by nothavingaplan orflow diagram. 
You can get away with unstructured pro- 
gramming when the program to be written 
is short and simple, but this program ran to 
over 70 pages of procedures. It wasn’t 
really the program as such that caused the 
problems; it took so long sorting out rela- 
tively minor errors and making the screen 
presentation acceptable that there was 
little time left to consider the operation. 

That may sound like a lack of plan- 
ning, but maybe it was more due to my 
assuming the program worked properly, 
rather than being my normal sceptical self. 
The outcome was a partially-working pro- 
gram, better in its user interface but still 
with some gaping holes in it. Maybe some 
of them will be sorted out later, but | had to 
say that the contrast between working with 
Archive and with the program | use often on 
A N Other machine was painful. 

The area which highlights the big 
weakness of Archive is that of testing 
Procedures and Screens. The language 
itself is good, but what a performance to 
modify and check what you write! Bear in 
mind that the program had several hundred 
small Procedures, combined into a couple 
of dozen groups. To modify anything in a 
group, you have to run Archdev (not Ar- 
chive, since this program was to run under 
the run-time version, Archrim), Load Ob- 
ject “flp1_procname”, scan through maybe 
a dozen individual Procedures, find the 
area that seems to need changing, make 


the change, Save Object “flp1_procname’”, 
then Run Object “flp1_boot” to run the 
whole program, select the option concerned 
and see if it now works as desired, then go 
back through the whole process when it 
becomes clear something is still wrong. 
Should you screw it so badly that 
there is no way out - easy enough with 
routines where the user has to press a key 
- you may have to reset, possibly making a 
hash of connected data files and having to 
start again from scratch. After doing this a 
few dozen times, with a few dozen groups, 
each with a dozen or so individual Proce- 
dures, one can get a bit browned off. In 
some ways, even so, this is easier than 
dealing with Screens, where the routine is 
similar but harder to get to grips with. 
From the user’s standpoint, such a 
program will probably work better in 
SuperBasic and compiled with DP’s Turbo. 
The programmer will have security, too, as 
few users will be able to modify compiled 
code. However, you may be like me and 
feel able to write simple Archive lines but 
uncomfortable writing in SuperBasic. If 
that’s the case, try observing a few “rules”: 


Draft a plan of what you have to 
achieve, and the routes to be taken to get 
to the various points on the way. 

Create Procedure names that have 
as much meaning as possible - don’t calla 
Procedure A2, for instance, when it is 
concerned with a listing name. Try some- 
thing like LISTNAME_PRO. 

Do likewise with Variables - don’t 
use AQDV$ when ORDERNOS$ is more to 
the point. 

If you have sufficient ram to hold one 
large Procedure group, create just the one, 
and do away with duplication of common 
Procedures (eg for printing to the screen) 
in several groups. 

Load both Procedures and data to 
ramdisk(s), to improve operating speed. 
You can use SuperBasic to WCOPY pro- 
gram and data files to ram then start the 
program from ram. 

Write backup Procedures to copy 
the data file(s) to two floppy disks atintervals 
during working sessions - don’t wait to the 
end of a session to do backups, as the end 
may come before you intend it to. 

Use Archdev and Archrim, rather 


than Archive, because Archrim takes less 
space and runs faster. 

Archive on the QL will never be a fast 
operator. Try to get the best out of it by 
using the run-time version, providing it with 
as much ram as possible, and using the 
fastest QL you can get - both those point 
imply a Gold Card, of course. 


Checking spelling 


Perhaps some of my past comments 
on this operation gave a false impression 
of my feelings on dictionary size. My in- 
tention was definitely not to imply that 
biggestis best where word-list (“dictionary”) 
files are concerned - far from it. Ken Whyld 
(Open Channel, July 1992) points to one 
dilemma, and the editor gave one solution 
for it. The larger the word list, the more 
“words” it is likely to contain that can mask 
incorrect spelling in documents. This is 
inevitable, as computer word lists are gen- 
erated from dictionaries which contain 
common abbreviations, such as the one 
Whyld cites. “dod” - if written in capitals - 
could be short for Department Of Defense 
(US spelling, of course). 

(My Chambers gives “dod” as ‘a 
slight fit of ill-humour; the sulks (often pl.) 
(Scots.); as “to poll, pollard or clip (obs or 
dial)”; and “a minced form of God, in Oaths” 
- all reasonable reactions to a spellchecker 
that won't pick up a mistyped “did” - Editor.) 

It is unfortunate that many 
spellcheckers are deficient in their ability to 
handle capital letters, and this is a func- 
tional reason for the problem he is worried 
about; if the checking mechanism were 
improved, it would not matter so much that 
such words are in large lists. As both Per- 
fectionand text87come with large and small 
word lists, the user can decide what his/her 
main problem is - spelling errors or typos - 
and choose the size accordingly. 

The weakness in handling capital 
letters regularly annoys me, but it may not 
trouble many users. Itis primarily technical. 
For example, how do you write the abbre- 
viations for megabytes, kilobytes and 
megahertz? The latter is perhaps the 
easiest; there are international standards 
for electrical terms, accepted by engineers 
and scientists. Units of measure named 
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after whoever created them are often allo- 
cated a capital, such as Hz for Hertz. 
Where the same initial-letter could be used 
for several different quantities, the larger - 
such as M for mega (millions) might have 
the capital and the smaller (Greek mu [] for 
millions) a lower-case or related symbol. A 
lower-case m denotes milli- ((housandths) 
asin millimetre. (“Thousands”, on the other 
hand, uses a lower-case k, from the Greek 
“kilo” (km for kilometre.) 

Where computers are concerned, 
the computer press doesn’t seem too well 
versed in the efforts made by the engi- 
neering and scientific communities. You 
can see kilobytes shown as kb, KB, Kb or 
kB, and megabytes as mb, MB, Mb or 
MG. The latter is surprising; presumably 
the “G” comes from mega, but the usage 
has to be wrong, surely? Another reason 
for capitals is the German manner of 
writing the full words, such as Kilohertz. 
As “byte” is not a name, a small letter 
seems appropriate, but|’m loath to change 
from my own normal usage of “B”. To 
confuse the issue further, computer 
people have chosen - not without reason 
- to use “k” for a value which is not 1,000. 
Akilobyte is 1,024 bytes, anda megabyte 
is 1,024 by 1,024 bytes (2 to the power of 
20). 


My own electro-technical German- 
English dictionary appears to accept both 
capitals and small letters for the qualifiers, 
so maybe there is not as yet a “right” way 
of putting them. 

(The Editor comments: I’m puz- 
zled by some of this. The computing 
and engineering journals | have worked 
with over the years have been careful 
with standard symbols. Engineers 
(electronics and computing) and pro- 
fessional journalists - in the UK and 
USA, at any rate - have a separate 
standard symbol for binary thousand 
(1,024): a capital K. The same symbol 
also denotes degrees Kelvin, a 
measure of temperature, which is not 
easily confused with binary thousands. 

The lack of an accepted standard for 
“pits” and “bytes” is a pest. We use MB for 
megabytes, amd Mbits or Mb for megabits. 
I’ve never seen MG for megabytes. German 
capitalises many common nouns, but that 
shouldn't affect the use of symbolic letters. 
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SHOOTER 


Many compilers of technical stand- 
ards think that engineers have an attitude 
too narrowly focussed on their own local 
practices or areas of expertise. Many engi- 
neers think that writers of technical stand- 
ards are wazzocks; | agree with both of 
them, but as most engineers and technical 
writers | personally work with handle ana- 
logue, digital, hardware and software de- 
velopment simultaneously, | pay close 
attention to their usages.) 


... And now, back to 


Returning to the spellchecking 
function, to cope with abbreviations, the 
checker needs to be able to recognise 
capital letters, which may be at the start or 
end of words, or in the middle. Some 
checkers can recognise that, for instance, 
“Germany” is correct and “germany” is 
incorrect, but that’s about the limit, and this 
is where the large word list can let you 
down. 

In practice, 10-20,000 words is 
enough, but a large separate list may need 
to be added if the user has a good collec- 
tion of abbreviations and proper nouns 
(such as “Joseph”, “Glasgow”, “Safeways”). 
My own experience has been that no more 
than about 10,000 words are added to a 
bought word list, and the same number are 
usually added to any new list - regardless 
of size - simply because they are almost all 
abbreviations or proper nouns which are 
rarely included in commercial products. 

The larger of the various Perfection 
word lists are an exception, as they have 
had many such words added to them and 
will generally not be caught out by common 
words such as “Sinclair” or “QL”! There is 
some merit, then, in having bigger lists, 
and this is especially true if you work in a 
trade which has its own vocabulary, or you 
make use of less common words, for 
whatever purpose. 

Don’t assume, though, that all 
strange words in your own particular field 
will be included in a list which has over 
100,000 words. In practice, you can find 
many quite normal words missing from 
150,000-word lists, and even 300,000-plus 
lists will not contain all words used in 
specialist areas. 


TROUBLE SHOOTER 


Cross-eyed OCR 


OCR (optical character recognition) 
has been a Holy Grail in the electronics 
development world for many years. 
Younger computer freaks may not realise 
how long such facilities take to develop. In 
my own experience, OCR ranks with blind 
landing as something which has taken a 
surprisingly long time to come to com- 
mercial fruition. If one ignores pioneer ex- 
periments, blind landing systems devel- 
opment dates from the early 1940s. We 
were working very seriously with two 
commercial system philosophies in the UK 
in the early 1960s, but such systems have 
reached the level of common, reliable use 
only in the past few years. Attempts at 
OCR presumably date back at least as far; 
certainly, | worked on production reading 
machines at the end of the 1960s. 

This doesn’t alter the fact that read- 
ing technology still has far to go, and you 
need to ignore much of the verbiage on the 
subject. There are several OCR compo- 
nents on'sale, and a very few capable 
software products to go with them, but they 
all suffer from basically the same constraints 
as before. The printed or written text needs 
to be of good quality and consistent form. 
What brought this to mind was the editor’s 
explanation of the gremlins that got into an 
article in the May/June issue. 

It may be fairly easy to scan text into a 
computer in the form of one image, but that’s 
a long way from translating that image into 
individual characters and feeding them in the 
correct formatinto a word-processing program. 
Performance figures of over 90% accuracy 
are commonly quoted for quite cheap OCR 
readers, and that sounds good at first reading. 
When you calculate how many errors that 
means per thousand words of text, it looks 
much less good. An article of the size of this 
one would have around 2,000 individual char- 
acters wrong at a reading accuracy of 90%. In 
the worst case, that would mean nearly 70% of 
the words having an error. A good typist can 
manage over 100 words per minute and will 
have been graded to an accuracy of 98%. At 
least, with OCR, errors may do no more than 
cause laughter, whereas even a small error 
when an airliner is landing in zero visibility can 
mean disaster. 


TROUBLE SHOOTER 


Disks again 


R Snow reported his problem with 
5.25-inch floppy disks, in the May-June 
issue, and his conclusion - that the trouble 
was with the drive not the disks - seems the 
correct one. Being very much of the “watch 
the pennies” inclination myself, | never 
consign a floppy to the bin without a big 
fight, but one has now defeated me - the 
first in more than six years (and close to 
1,000 disks). It was an old Philips-brand 
5.25-inch 360 KB one that has held the 
Turbo-DOS operating system in its youth. 
Out of curiosity, and for the benefit of 
clients who know little of the innards of 
disks, | opened it up and was mildly sur- 
prised to see what seems like a paper-thin 
piece of dishcloth between each side of the 
casing and the magnetic platter. 

The platter itself is very flexible and 
it is not surprising to hear of disks being 
doubled over and still coming up smiling 
when used afterwards - but don’t try it. An 
example of this occurred about the same 
time, when a well-known (PC) software 
company sent me an upgrade to its oper- 
ating system, in a flimsy A4 envelope, the 
5.25-inch disks arriving with marked kinks 
in them but giving only a slight hint of 
trouble when used. In the case of my sole 
dud disk, the reason was clearly evident - 
there was scoring on one side, where the 
read/write head had apparently come into 
more-forcible contact than usual with the 
magnetic surface. 

Given reasonable care, floppies re- 
ally shouldn’t give you trouble, even over 
periods of five years or more. During a 
recent re-organisation, some of my old 3.5 
inch disks were reformatted, and files 
transferred between them, with no sign of 
problem; the files on them dated back as 
far as 1985 and had not been touched in 
the intervening years, other than being 
used read-only for tests, now and then. 
Surprisingly, one disk that had (not long 
ago) failed to format properly in one PC but 
had formatted correctly in the QL proved 
itself quite happy to format without error or 
murmur in another PC. Perhaps for the 
same reason, three or four commercial 
program disks which had behaved without 
problem in one computer gave reading 
errors in another. 


Times change 


What does seem to be true is that the 
quality of batches of disks varies appreci- 
ably, and having a known brand name on 
the casing is no guarantee of reliability. 
Some time ago, you might have been safe 
buying from the same supplier at intervals 
of months, even years, because your 
supplier might well have been buying from 
the same source all the time. This is unlikely 
to be the case now. Fora few years, supply 
was greater than demand and dealers took 


to buying job-lots from wherever they could, 
to keep their own prices competitive. 

Obviously, quality tends to vary when 
the source is not constant. Recently, there 
have been regular reports of a general 
shortage of 3.5-inch disks, leading to some 
increase in prices, but this shouldn’t be 
expected to improve the quality situation. 
The reason generally given for the short- 
age is that two software suppliers - IBM 
and Microsoft - have been selling so many 
copies of their operating system (OS/2) 
and front-end (Windows) programs, re- 
spectively, that they have taken a large 
slice of the disk supply. OS/2 version 2 
comes on 21 high-density disks, no less! 
(Compare that with the economical two 
rom chips in which Qdos sits). The short- 
age doesn’t seem to extend to DD disks, 
fortunately. 

Those happy users having extra- 
high density (ED) drives may be able to get 
the disks at better prices before long, as 
the first non-IBM PC systems equipped 
with 2.88 MB drives have appeared in 
adverts. However, the (mainly-PC) com- 
puter magazine that claims to be “the best” 
still stated in a recent issue that ED disks 
cost £10 each - maybe PC users should 
buy from Miracle Systems. As Miracle 
provide 10 disks in their price of £175 
(including VAT) for dual ED drives, that 
would seem to suggest they are almost 
giving the drives away. 

One incidental, but significant, 
advantage of using ED drives is the 
space saved in storing disks. An ED 
disk holds 3.2 MB of files, which is 
more than four times what a DD disk 
holds; roughly, it takes only two ED 
disks to hold the same as nine DD 
ones. If you are short of workspace, 
this saving can make computing life 
much easier. One small box of ten ED 
disks from Miracle might well suffice 
to hold everything you need. 


Demo disks 


The new editor of Quanta, John 
Vanags, made what sounds like a good 
suggestion in his July issue. He made the 
obvious point that users are not keen to 
part with their money without knowing 
something about the goods first. Not all 
users can get to Quanta meetings and see 
software demonstrated by the suppliers. 
An alternative way of learning something 
about a program would be through a 
demonstration version of the program. 
Supplying demo versions of WP and other 
types of program has been common 
practice in the PC world for years, and it 
must certainly have influenced the buying 
decisions of a fair number of users. Ademo 
version is essentially a cut-down version of 
the program, capable of showing major 
features but not usable for serious work by 
the recipient. 

For example, you might be able to 
create documents, but not print them. One 


very good demo disk | received allowed 
you to use many of the program features 
and even to print files which were supplied 
(but not ones you created). Other demos 
merely display program features without 
allowing the viewer to get involved, but this 
approach tends to make you go glassy- 
eyed quite quickly and seems much less 
effective as a selling tool. 

By-and-large, the demo disks | have 
had were free; the only one | recollect 
paying for was from Microsoft (no surprise) 
and cost about £10. QL suppliers aren’t in 
the same money league as PC ones, and 
demo disks would almost certainly have to 
be paid for, but the payment could be made 
refundable if the full version of the program 
concerned were purchased subsequently. 
Demo disks just might reduce the amount 
of piracy - it is very easy to ask a friend for 
a copy of a program, “to see what it is like”. 
Any comments, suppliers? 


Text87 manual 


In response to various requests, 
Software87 have revised the instructions 
for the Plus-4 version of text87. There is 
more information on subjects which may 
have caused users problems previously, 
such as the Room command. A consider- 
able number of changes have been made 
to the program during the transition from 
issue 1 through 2 to the current 3, and 
much of the added material concerns these 
changes. A welcome addition is a Glossary 
and Index. The on-screen Help information 
also has been extended. The program is, 
overall, quite a bit easier to use now than 
when it first came out; as indicated in last 
month’s review, it is a very much more 
capable program than version 3 was and 
should find favour with both existing T87 
users and late converts from Quill. 


Name change? 


Bill Richardson of EEC is now trad- 
ing under his own name as well, according 
to his advert - from the same address as 
previously. Amongst other items of interest, 
he is offering hard disk drives, in either kit 
form or ready-boxed, and interfaces to 
allow various combinations of devices to 
be connected through the QL 64-way ex- 
pansion port. He still has stock of QLs, and 
of both DD and HD 3.5-inch disk drives. 
The QL World readers’ offer of new QLs at 
£69.95 is going like hot cakes. 


Readers’ letters 


There has been something of a hia- 
tus, with letters presumably going to the old 
addresses and taking a long time to catch 
up with us. Please check the new address 
for correspondence, at the front of the 
magazine. It is different from the one in the 
May-June issue. 
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Media Manager Special Edition (MMSE) Is a program to 
be used both when things have gone wrong as well as 
when things are perfectly OK. It allows for automatic, 
semi-automatic and manual correction of a huge variety 
of disk and tape problems. It allows you to explore disks 
and tapes to your heart's content, producing all sorts of 
different diagnostic reports. MMSE Is very simple to 
operate, being menu-driven and assuming no degree of 
computer knowledge whatsoever. 


MMSE also allows you to tidy, catalogue, sort and order 
your disks and cartridges. 


The standard Media Manager Is both less powerful and 
less user-friendly, but manages to work on an 
unexpanded QL. 


Both programs allow for data transfer between PC and 
QL. With MMSE, this transfer is at file and directory level, 
Is bi-directional and is completely automatic. 


These programs are quite primitive compared to 
Professional Publisher. However, if you have not 
experienced that program as yet, you will find both of 
these very competent. Both are capable of producing 
excellent results. The cheaper one has fewer features but 
is able to run on smaller systems. 


With the sole exception of Perfection, this is the best 
word handling system on the QL. Editor's features 
Include an unrivalled degree of programmability and the 
ability to cope with the entire 256 character ASCII set. 
The Special Edition has enhanced document-type 
facilities, Including column blocks and on-screen page 
break displays. Neither program Is sultable for 
computing novices. Until Perfection, Editor Special 
Edition would have been our ‘Desert Island Program’. 


Editor SE can do a few things that Perfection can't, so 
the Ideal combination Is to have both (they are 
compatible at file level and can multitask). If you order 
Editor SE at the same time as Perfection, you can have 
Editor SE at half price. 


The Astrologer program teaches you Astrology from 
scratch and enables you to automatically produce text 
narrative on personality delineation, year-to-year and 
minute-to-minute life predictions, compatibility 
interpretations and so on. Whether or not you believe In 
astrology - indeed, especially If you do not — this 
program Is one that you cannot afford to have. You can 
tallor the readouts (both in terms of quantity and what 
Is said) to your own particular requirements. The amount 
of fun you can have with this program Is endless. Do not 
blame us If you start believing In astrology, though! 


Astronomer Is an extremely fast and accurate solar 
system calculator, with planetarium views, planet faces, 
eclipses, cinerama display etc.. 


Turbo Is the finest BASIC compiler for the QL and 
arguably the finest BASIC compiler for any computer! 


Turbo automatically converts working BASIC programs 
Into optimised machine code, usually with no need for 
human intervention. The benefits of this conversion are 
vastly enhanced running speed (as well as much faster 
loading, encryption and automatic bug fixing for a variety 
of QL interpreter oddities). Typical speed-up Is 40x - 100x. 


Turbo Is provided with a 200 command toolkit, adding 
many useful commands to BASIC. Most of these 
commands will be of immediate use to the programmer, 
whether he Is a novice or an expert. There are commands 
to load strings and floats Into RAM, and to extract them 
automatically; to search memory and to move Its contents; 
to control jobs and change their priorities, manage pipes, 
allocate and deallocate memory, to control both rubber 
and virtual arrays, to present INPUT with an editable 
default, to have random access to files and much more. 


Toolkit Ill starts where Toolkit Il stopped, adding about 
60 new commands and enhancing many existing dual 
functions. Toolkit Ill Is available either on disk or on 
ROM, and works whether or not you have Toolkit Il. 


Toolkit II] commands can, with only a couple of 
exceptions, be compiled using Turbo. 


All QL owners have a copy of Archive, supplied free with 
the QL. While Archive Is competent, it Is very hard to get 
to grips with and Is not particularly fast. QFlick presents 
a very convenient alternative - a snappy , simple-to-use, 
pointer-controlled card file database. You can move data 
between QFlick and Archive in either direction. 


QFlick Is not Itself programmable but we document its 
data structure and give guidance on how to program it 
using Turbo. 


This suite of utilities will greatly enhance your use of the 
Archive database system. 


Archdev + RTM Is a straight replacement for Archive: It 
gives enhanced speed, greater workspace and a much 
cleaner boot-up. All your existing applications will work. 


Database Analyser provides very fast and comprehensive 
statistics about your Archive databases. 


Archive Tutorial proceeds systematically through the 
whole philosophy and grammar of Archive, providing 
you with expert and patient guidance. 


Names + addresses, Mailmerge and Dat-Appoint are 
ready-to-run, off-the-shelf Archive applications, 
providing an address database, mallmerging and 
appointment diary respectively. You now have no excuse 
not to use Archive. 


SEdit allows you to create and edit screen format files in 
Archive. Screenprint allows you to print them out. 


Recover allows you to get back lost Archive databases, 
created when you switched off the computer without 
properly exiting from Archive. 


XRef analyses the structure of a BASIC program, 
providing detailed reports on things like variable usage, 
what calls what, dynamic call hierarchy of procedures 
and functions, and so on. 


SuperBasic monitor actually monitors and reports on the 
performance of BASIC programs as they run under the 
interpreter. 


BetterBasic analyses and automatically corrects structural 
flaws In your programs and allows you to customise 
things like indentation, number of statements per line, 
filtering out of noise words, etc. 


The three programs together provide a matchless 
diagnostic and auto-correcting facility for BASIC 
programs. 


This program copies files at high speed between devices, 
performing translates as it goes along. Ideal for all sorts of 
applications, Including transfers from microdrive to disk. 


This Is an Incredible mathematical compendium for the 
QL. Pride of place goes to the symbolic problem solver: 
this can solve equations, simplify expressions, factorise, 
expand, etc, all symbolically. If you could sneak this one 
Into a maths examination, you would have a formidable 
ally. QMaths knows about all the algebraic operators, 
powers, roots, brackets, trigonometry, matrices, 
determinants, vectors, factorials, permutations, 
combinations, binomials, exponentials, logarithms, 
hyperbolics, Inverse functions, infinite series including 
Taylor & Maclaurin expansions, complex numbers, 
conversions, Fourier series, and lots of calculus: both 
differential and integral, Induding Integration by parts 
and definite Integrals. QMaths optionally displays its 
workings and comes with a superb interactive tutorial. 


The package also contains an interpretive, fractal, image- 
generating language with loads of beautiful fractal 
programs supplied for you to use and edit - no 
programming skill Is required. 


There Is also a multiple precision floating point maths 
package, glving calculations at precisions up to over 600 
decimal digits of accuracy. 


There Is even more to this system, but we think we have 
told you enough. 


The latest version of Tony Tebby's superb monitor: an 
absolute must for those who really want to know what 
is going on in the QL. No other machine code monitor 
even comes close. 


Do not confuse this program with SuperBasic monitor, 
which monitors SuperBasic, not machine code. 


This program compares files - data or program — at 
colossal speed. Where a mismatch is detected, the 
relevant areas are highlighted and you can shuffle, 
displace and align very easily. 


Cash trader with Analyser Is an accounts system designed 
by businessmen and not by wretched accountants! 
Consequently, it has excellent reporting and 
management facilities, and is very flexible. It Is aimed 
primarily at the layman, probably a sole trader running a 
small or medium sized business. All the features you 
would expect - including audit trail — are present. 


Payroll Is a reasonably flexible system designed to 
automate the payroll function in small businesses. 


Both programs are configurable, with editable defaults 
letting you adapt the programs from year to year. 


This is the ultimate hard disk backup and management 
utility, with all the sophisticated features you could 
want. User dialogue Is via overlapping pop-up windows — 
the whole program Just feels right. It Is possible to scan 
the disk at great speed, too. 


This permits you to add password protection to disks, to 
optionally increase disk storage capacity on DSDD drives 
by 36K and to increase speed of access by as much as 
30%. All this is done while maintaining full compatibility. 
Automatic file management is also provided. 


These are extremely fast and efficient C compilers, 
complying with and sel scl Small C definition. 
The Special Edition goes much further, including support 
for structures, pointers, long pointers, >64K code size, 
direct access to QDOS traps, etc. The Special Edition C 
generates code that runs about twice as fast as the other. 


PERFECTION SPECIAL EDITION 
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mj POWER 

PERFECTION SPECIAL EDITION has 253 (two hundred and fifty three) direct/menu commands 
(not counting options in sub-menus), plus 32 special characters (like Bold on) that can be 
inserted ‘directly’ plus intelligent (and now excellently documented) macros. Comparisons with 
other word processors on the subject of power are hence quite unnecessary. 


mm EASE OF USE 

Independent reports, customer feedback and published reviews (of its less 
able but still excellent predecessor, PERFECTION) leave one in no doubt as 
to which word processor is friendliest - PERFECTION SPECIAL EDITION, 
with its intuitive, silky handling. Uniquely, it has two operating modes, with 
both menus (visible or invisible — they even look like Quill’s) and direct 
commands (for when you familiarise yourself with the system). Uniquely, 
both modes are ‘re-entrant’ (so you can use any menu option or direct 
command while you are in the middle of performing another option or 
command — block handling, etc, becomes a dream). Uniquely, PERFECTION 
SE has fully automatic memory management, grabbing and releasing RAM 
instantly as your document grows or shrinks — programs without this don't 
take full advantage of the multi-tasking abilities of the QL! Uniquely, 
PERFECTION SE leaves you in the driving seat, not juggling things around 
‘underfoot’ while you are typing. Uniquely, PERFECTION SE allows up to 
nine different documents to be handled simultaneously from one copy of the 
program — each with totally independent margin, tab, justification, control 
panel, etc, settings. Uniquely, each document can itself have up to six environment settings, 
each settable or recallable instantly with a single keypress combination. Each document can 
have any number (up to 500,000 on GOLD CARD) of candidate blocks! Each document can 
have two independent windows (of any depth, of any (but same) width across) ‘on to’ it, even 
with overlapping text — that allows you to edit in one place while viewing another, to compare 
‘before editing’ with ‘after editing’ (you can arrange to have one window remain ‘frozen’ in time), 
etc. Uniquely, we realise how much faster it is to type in something like CTRL/SHIFT/F5 than 
(say) F3 F3 R — both involve three keys, but as the former doesn't require the keys to be 
pressed in just one specific order, or to be released in any order at all (together will do), it is in 
practice twice as fast as the latter, where no key may be pressed until its predecessor is 
released. PERFECTION SE takes advantage of all this — it is the little things that count! 
Uniquely, by providing eight user-definable strips, PERFECTION SE allows you to cope with 
printers of the future, not just the printers that now exist — you can attach the strips to any 
printer features. Uniquely, PERFECTION SE's status lines give full information on all relevant 
global settings. And the manual has an index. Also, it has all the important bits at the front, 


Hi WYSIWYG? 
By the latest definition of this term, neither is PERFECTION SE fully WYSIWYG, nor are other 
QL word processors. WYSIWYG means what you see on screen is exactly what you get on 
paper. Exactly — down to every wiggle in every character in every font. 


To get true WYSIWYG, use PERFECTION SE’s fully automatic link (supplied as part of 
PERFECTION SE) to PROFESSIONAL PUBLISHER, where you will get 100% WYSIWYG. 
100%? Yes, 100%. With this combination, adjust the horizontal and vertical magnification on 
your monitor (ie calibrate it once and for all so screen circles correspond to same-diameter 
printed circles — poor monitors may distort a little bit at the edges). Now you can place your 
printed output from PERFECTION via PUBLISHER over your monitor screen, and get a match 
that is more perfect than is your eyesight. Now that is WYSIWYG, 


mi SUPERB PRINT QUALITY & FLEXIBILITY 

Uniquely, using the aforementioned automatic link, you can output PERFECTION SE 
documents using over a thousand fonts (a huge variety of styles and sizes, supplied on the 
PUBLISHER and TOOLBOX disks) on virtually any printer — from the humblest Epson RX80, 
Brother M1009 or Star LC10 (which are all single font machines when used with most word 
processors) to top-end lasers. You aze wot limited to the fouts Cult tute the 
frcwter// All PERFECTION SE bold/underlined/ italics/SUPEt/s.,), etc, settings are 
preserved. Proportional spacing and micro-justification are automatic, even when you 
mix fonts of differing widths and heights (even on the same line), vary line spacings, 
etc. Uniquely, you are not trapped with one type of micro-justification (ie adding all the space 
between words, and using the predefined widths of characters as their separation) — with our 
system, you can vary (in 5% steps) the proportion of micro-spaces added between words to 
that added between characters (the latter in proportion to their individual widths). Settings 
around 65%-35% — not the 100%-0% forced upon you by some other word processors — 
seem to give the most pleasing results. Uniquely, you are not limited to mere rectangular 
columns plus headers/footers — that's all the rest can do — you can output in any sequence to 
any number of frames (text flowing from one to the next), each of any shape — irregular 
polygons of up to 66 sides, circles, multi-column or part-column boxes (hundreds of types of 
borders, thousands of textures), doughnuts, wrap-around shapes, even re-entrant ones 


the best! 


Professional Publisher is 
No other dasktop 


pblisher for the QL even comes close, 


(join-the-dots’ type borders, even with intersecting edges) — all with micro-justification and 
proportional spacing! Look at the example on this page. Of course, if super fancy output or 
special effects are not of the essence, PERFECTION SE's direct printer output is more than 
capable of meeting your needs. 


Mi THE FASTEST 

For benchmarking, we've used an unimpeachable file — not one created 
specially — a public domain version of the first book of The King James 
Bible, all fifty chapters of the book of Genesis. This came to one hundred 
and forty pages, well over forty two thousand words excluding 
headers and footers, well over two hundred and twelve thousand 
characters excluding justification ones and one thousand five 
hundred and thirty three indexed verses!! We didn't use a smaller file 
(as used to benchmark other programs) as PERFECTION SE's timings for 
most operations then become impossible to stopwatch (too fast!). The 
hardware used for all timings was GOLD CARD: speeds would be further 
improved by over three times using the ST/QL 030. Of course, 
LIGHTNING SE was used. File operations were to ramdisk: normal slave 
blocks would give identical times. All settings on everything were for 
maximum speed, except where indicated to the contrary — we have the sense 
not to force full speed upon you in operations like scrolling and global 
Search & Replace. PERFECTION SE's speed for these is switchable 
(at run-time and when configuring), as too great a speed may cause 
overshoot (with scrolling) or fatal alteration (if there is human error inputting the target or 
replace strings). Here are the benchmarks for this huge file: 


Load 140 pages: 0.6 seconds (yes 0.6, not 6!) zx Import 140 pages: 0.6 seconds (yes 0.6, not 
6!) vx Save 140 pages: 0.5 seconds (yes 0.5, not 5!) 2 Export 140 pages: 0.5 seconds (yes 
0.5, not 5!) vx Case-sensitive search from top for word at bottom: 0.4 seconds (yes 0.4, not 4!) 
vx The same, but case case-insensitive: 0.5 seconds (yes 0.5, not 5!) 2 Case-sensitive search 
backwards from bottom for word at top: 0.4 seconds (yes 0.4, not 4!) x The same, but case- 
insensitive: 0.5 seconds (yes 0.5, not 5!) vx Automatic Search & Replace, in Fast (No Query) 
mode, of last 600 occurrences: 7.4 seconds (same length replace string); 7.7 seconds (shorter 
replace string); 10.5 seconds (longer replace string — longer time as we deliberately chose a 
high density of replaces to handicap PERFECTION SE into auto-managing memory — without 
causing any heap fragmentation, but still with only a 0.005 second overhead per replace!) 
vx Automatic Search & Replace in Slow (‘Querying’) mode: arbitrarily slow, typically 30 times 
slower — because we deliberately allow for human response time (in case you want to abort) 
before proceeding from one replace to the next — booby prize to anyone for benchmarking us on 
this setting!! vx Scrolling 100 lines of text, up or down, by full-width screen page: 1.5 seconds 
zx Scrolling 100 lines of text on full-width screen, line by line, in slow (full) mode: 5.7 seconds 
(down)/5.8 seconds (up) vx As above, -but in medium speed mode: 4 seconds vx The same, but 
in fast mode and default settings: 13.5 seconds to scroll through the whole massive document, 
averaging 0.23 seconds per 100 pages (!) — and this could be made up to ten times faster by 
reconfiguring PERFECTION SE vx Reformatting paragraphs, changing margins, justification, 
etc, of existing text: cS times faster than predecessor x’ Inserting (or undoing) emphasised, 
underlined, italics, superscript, subscript, 8 strips, 6 environment settings: Instant 
(i.e. immeasurable) vx Navigation to line or page or to top or bottom or to 8 markers or to 
highlights/blocks: Instant zx Setting new margins, justification, etc: Instant z% Deleting block of 
100 pages: 0.3 (yes, 0.3 not 3!) seconds vx Copying/moving block of 100 pages (not just 10!), 
downwards or upwards: 3.4 seconds (yes, including all the time for automatic memory 
management and anti-fragmentation — other programs are light-years behind) vx Spellcheck as 
you type: Ten times faster than anyone can possibly type vx Spellcheck all 140 pages in the 
document using the 350,000 word Mega Dictionary: 3.9 seconds (20 ‘errors’ — like ‘pluckt'!) 
vx And using our tiny dictionary (well, tiny by our standards — large by comparison with most 
others): 5.1 seconds (566 ‘errors’) v& Time taken to create user dictionary from the results of the 
second spellcheck (566 errors): 0.8 seconds to extract all ‘errors’ from document and clean 
document; 1.9 seconds to create a full user dictionary therefrom and also a sorted, duplicate- 
free wordlist file (for browsing) v& Spellcheck file (ASCII or native): Even faster. vx Print first 10 
pages to file: 3.5 seconds, vx Change every occurrence of God to in bold underlined 
italics, strip 2 -—9.5 seonds! 


For prices, see the coupon page of our ad. For more info, read our detailed ads in early 1991 for 
PERFECTION, plus the extra features of the SE (well, about half of them) listed in the June- 
August 1992 issues. You can upgrade from the standard PERFECTION (or PLUS) to the 
SPECIAL EDITIONs for the difference in current price, plus £10 (no manuals or dictionary disks 
to be returned — we'll send manual supplement), No discount to users of other word processors. 


QUICKLASER — The definitive output tool from PRO PUBLISHER to HP LaserJet II (or 
compatible) printers. Printed output quality subjectively exceeds that from any other QL product. 
TRANSFER UTILITY SPECIAL EDITION — Does everything — 16 case change options, 14 
types of sorting (multiple sorts possible), auto string translations, etc. 

LIGHTNING SPECIAL EDITION GOLD CARD VERSION — See June-Aug 1992 QLW for 
details: optimal speed from GOLD CARD, ST/QL, THOR XVI. Free upgrade from the ROM SE 
version (return ROM + disk) if you are ordering something else at same time: if not, £10 charge. 


STOP PRESS/PRODUCT INFO 


PC CONQUEROR GOLD SPEC{AL EDITION | ‘ ; ; 
A fantastic all-new software system making your QL into a PC and enabling it to run PC 
software. PC CONQUEROR GOLD SPECIAL EDITION will operate ei with GOLD (or other 
ae hardware giving 1.5 Mb RAM or more). It has (of course) all the features of standard 
CONQUEROR, and in addition: 
* Full and automatic support for expanded memory Keomplyins with all the relevant PC 
standards). On a Gold Card, for example, the user wil ae 736K base memory (vs only 
640K on "real" PCs, and 667K on standard PC CONQUEROR) PLUS expanded eet variable 
between OK and 944K (could be higher if you have even more RAM on your QL). The presence 
of expanded memory improves the performance of most PC software, and is essential for 
the operation of some of the more modern and/or advanced PC programs. Further, no 
separate "driver" needs to be installed from the DOS, savi even more RAM over 
conventional PCs and operating systems (where a difference of as little as 4K is 
considered worth mentioning as a substantial advantage). Part or all of the expanded 
memory can be allocated to ramdisk(s) and/or disk cache(s). 
* Ful support for high density (HD) disks (though the PC CONQUEROR GOLD SPECIAL EDITION 
works per ee well on single or double density drives too, if that is what_you have), 
iving you 2880 sectors per disk. You can now read, write and format HD disks 
tprovided of course that you have HD or ED drives on your QL), and the disks you use 
will be completely interchangeable with (in both directions) and indisti ishable from 
DD and HD disks produced on a "real" PC! Disk access speed for HD is better than twice 
the speed of double density (which was all that standard PC CONQUEROR could handle). Of 
course you can still read, write and format PC DD disks too, if you wish. 
* You can now easily create a PC "hard disk" on any QL device (including floppy disk) 
and boot up from it if you wish. From within the PC, that_ drive will look and behave 


Qbos like a hard disk ~ (and a very fast one too if you use RAM as the QL device). From 


DOS the hard disk will look like a normal QL file, so backing-up is a dream! 
feces foatlys if you have (or are going to acquire) ED drives (from Miracle Systems or 
elsewhere), you will now be able to create any number of pseudo-hard disks (with over 
3,200,000 bytes per individual disk), and automatically boot from them if you wish. Disk 
access speed is ayaa five times faster than with DD drives. This is an excellent 
way to use PC CONQ R GOLD SPECIAL EDITION. 

* Automatic sensing and switching between disk types (360K/720K/1.44Mb) at DOS level, 
with manual override! 

* Upto just over 50% faster operation than standard PC CONQUEROR on most Gold Cards (PC 
COND) R GOLD SPECIAL EDITION automatically determines whether your Gold Card can run 
the software at accelerated speed. Even if it cannot, you will still get faster 
operation than with the standard PC CONQUEROR. 

* You can design, if ie wish, your own colour map so that all screen colours are 
ee eared to your. liking - tailor PC programs so that they look the way you want them 
to (of course, no PC can do this). 

* Many other Opt tases Gas and features, enlarged configurator and supervisor mode. 

* Fully compatible with all versions of MS-DOS, DR-DOS and PC-DOS from v1.0 to v6.0 
arrest inclusive. 

* PC CONQUEROR GOLD SPECIAL EDITION pacseee includes a copy of the standard PC CONQUEROR 
too, in case you have other or setups with less than 1.5 RAM. 

* PC CONQUEROR GOLD SPECIAL EDITION costs £99.95 including VAT and delivery. Standard PC 
CONQUEROR has been reduced to just £59.95 inclusive — excellent value — and SOLUTION PC 
Emulator to just £29.95 inclusive. Existing Digital Precision emulator owners can 
upgrade for Ast the difference in current advertised price, plus £10 (so the upgrade 
from PC CONQUEROR to PC CONQUEROR GOLD SPECIAL EDITION is just £50, for example — return 
only the disk and not the manual. The upgrade from SOLUTION is £80: send back 
everything). Please upgrade now as the upgrade price is liable to be increased soon. 


DR-DOS v6.0 
DOS v5.0 has now been superseded by DR-DOS v6.0 with many new features, probably the 
most useful of which is disk compression "on the fly" (i.e. data is automaticall 
compressed before it is written to the disk and automatically decompressed as soon as i 
is read off the disk - so everything works as before). Compressions range from 2x — 8x 
depending on the type of file: imagine how huge your storage devices will become! There 
many other enhancements over v5.0, including an on-line DOS tutorial, built in disk J 
cache, many diagnostic and backup utilities and much more. DR-DOS v6.0 will work with 
all our PC emulators. The price including all documentation (two large manuals), ready 
reference guide and our pre-configured QL/DR-DOS v6.0 disk (ready to run) is £80, or a 
concessional £70 if ou have purchased an earlier DOS from us (this is not an upgrade — 
you keep the old DOS too). If bought at the same time aS PC CONQUEROR GOLD SPECIAL 
DITION, the combined price is £179.95, or £139.95 with the standard CONQUEROR, or 
£109.95 with SOLUTION. 


THS MATHEMATICAL SYSTEM PART TWO atl. 3 
follow-up program to complement QMATHS, giving excellent and optimally speeded 
Mandelbrot and Julia set visuals, enhanced statistical functions, terrain plotting, 
function evaluation and much more. The price is £59.95, or just £99.95 for the pair 
(QMATHS Parts 1 and 2) - a saving of almost £30! 


animated graphics, data compression, language design, parsing, maps, object-oriented THS MATHEMATICAL SYSTEM PART ONE 69.95 
control etc. If all you want to do Is generate adventures, though, you do not need to be ‘THS MATHEMATICAL SYSTEM PART TWO 59295: 
@ programmer to use it. This is a purchase you will never regret. ‘THS MATHEMATICAL SYSTEM (PARTS ONE & TWO) 99795 
MACHINE CODE MONITOR v2.05 39.95 

VER ARCHIVE UTILITY 19.95 


REVERSI GAME 9.95 

SEDIT + SCREENPRINT ARCHIVE UTILITIES 39295) 

SOLUTION PC EMULATOR WITH DR-DOS v6.0 109.95 

SOLUTION PC EMULATOR 29.95) 

SPELLCHECKER WITH DICTIONARIES 49.95 
EMULATOR 


Ss é 
SUPERBASIC MONITOR 24.95 
SUPERFORTH COMPILER WITH REVERSI 39.95 


PEDIT 


A fast, modern and capable printer driver for the programs bundled with the QL. 


SUPER ASTROLOGER 24.95 
MICROBRIDGE SUPER BACKGAMMON GAME 9.95 
Superb contract bridge bidder (ACOL etc) and player, using millions of random but SOMES Vit Wet as rf ae 


reconstructable hands. Microbridge also Includes a state of the art Interactive bidding 
tutor and a clear instruction manual. There Is nothing like this anywhere else! 


LKIT III : 
TRANSFER UTILITY SPECIAL EDITION 29.95 
TRANSFER UTILITY 9.95 
TURBO BASIC COMPILER + TOOLKIT 79.95 
ULTRAPRINT SCREEN DUMP UTILITY 19.95 
XREF SUPERBASIC PROGRAM ANALYSER 29.95 
KEY>>>>>>> Available either on cartridge or disk 

Available only on disk 
Minimum 512K exp:only available on disk 


SUPER ASTROLOGER 


Avery cut-down version of Professional Astrologer —still great fun, thoughl 


SUCCESS CP/M EMULATOR 


Allows your QL to run CP/M programs at great speed. 


Minimum 1.5Mb RAM:only available on disk 
As well as cartridge or disk, you get a ROM 


3—D PRECISION CAD SYSTEM 49.95 d 
SPECIAL DEALS phy eee TOOL SPECIAL EDITION ee : 

5% off total if you buy 2 programs/upgrades; Ree “95 
ARCHIVE DEVELOPMENT SYS + RUN-TIME MODULE 29.95 a 
10% off 3; 15% off 4; 20% off 5; 25% off 6+ ARCHIVE TUTORIAL Ries 19.95 a 
. . . i a 
Upgrades cost difference in price + £10 BLOCKLANDS GAME 9:98 ¢ 
Non-UK Europe add 5%, rest of world 10% CASH TRADER v3.3 + ANALYSER 99.95 c 
For full terms and conditions, please refer to any of our QL World ads from Jan-Nov 1990, or write in including a SAE COMPARE FILE UTILITY 19.95 a 
COPY UTILITY FOR BACKING UP 9.95 a 
oe Eerie ne G TEAL WITH C68K COMPILER aoe c 
TRAN: “4 ic 
CPORT BASIC TO C CONVERTER DATABASE ANALYSER FOR ARCHIVE 19.95 a 
DAT-APPOINT APPOINTMENT DATABASE SYSTEM 19.95 d 
This program translates SuperBasic programs directly into C source code, automatically. DESKJET/LASERJET DRIVER FOR PRO PUBLISHER 19.95 c 
This C source code may then be edited or compiled. If you want to move programs to C DESKTOP PUBLISHER SPECIAL EDITION 39.95 c 
for migration to other hardware, or want to accelerate your programs, or Just want to DESKTOP PUBLISHER 24.95 d 
learn C the easy way (chuck BASIC In one end and examine the C that spews out of the DIGITAL C COMPI 29.95 a 
other), CPort is the system for you. DIGITAL C SPECIAL EDITION 49.95 a 
CPort Is friendly and tolerant of poorly written BASIC. There Is even a method of dealing pee ee i“ oe 4 
with unusual BASIC keywords. The generated C, which can be switched between the DR-DOS v6.0 STATE OF THE ART PC OPERATING SYSTEM 79.95 e 
ANSI and Lattice Industry standards, is very readable and is often optimal. CPort's user EDITOR SPECI AL EDITION 49. 95 d 
interface Is extremely friendly. CPort Is available with or without the C68 compiler. EDITOR ‘ 29 ‘ 95 a 
EYE-Q GRAPHICS SYSTEM 39.95 a 
GAMES. COMPENDIUM. (ALL FIVE GAMES 19:98 & 
. a 
SUPERFORTH COMPILER WITH REVERSI GRAFIX 24-PIN UNIVERSAL PRINTER DRIVER 14.95 e 
cegCent aCe ce aa 3 & 
Forth is the most logical computer language. This compiler produces multitasking code. g a 
The marwal teaches you Farth-€3 from seratch 3 IDIS SPECIAL EDITION 39.95 d 
LIGHTNING ACCELERATOR 24.95 a 
LIGHTNING SPECIAL EDITION ACCELERATO! 49.95 h 
WATEMMRGE DATABASE. SYSTEM O* COLD CARD 19:98 a 
a 
IDIS SPECIAL EDITION MEDIA MANAGER SPECIAL EDITION 49.95 d 
IDIS MEDIA MANAG 24.95 a 
MEGA DICTIONARY 29.95 § 

These intelligent disassemblers make the otherwise terrifyingly complex task of MICROBRIDGE 39.95 
understanding other people's machine code programs absurdly easy. The SE version, NAMES AND ADDRESSES DATABASE SYSTEM 19.95 d 
which has a higher hardware requirement, sorts out some routines, replaces addresses PAYROLL SYSTEM 49.95 c 
with names, untangles data from code and much more. PC JUEROR GOLD SPECIAL EDITION WITH DR-DOS v6.0 179.95 g 
PC IR GOLD SPECIAL EDITION 99.95 g 
PC IR WITH DR-DOS v6.0 139.95 e 
PEDIT PRINTER DRIVER FOR XCHANGE 19:98 
2 a 
QKICK FRONT END SYSTEM PERFECTION PLUS SPECIAL EDITION WITH SPELLCHECKER 139.95 c 
PERFECTION PLUS WITH SPELLCHECKER ; 99.95 e 
This Is a simple, easy-to-master, pull-down menu controlled multitasking front end. QKick PERFECTION SPECIAL EDITION WORD PROCESSOR 99.95 ‘c 
runs In the background and can be called up at any time. It provides you with notepads, PERFECTION WORD PROCESSOR 59.95 d 
sophisticated file/sector/RAM handling, backing up facilities, a clock, diary, calculator, PERFECT POINTER ILS 29.95 a 
mini-database and so on. PROFESSIONAL ASTROLOGER WITH ASTRONOMER 69.95 a 
PROFESSIONAL ASTROLOGER 59.95 a 
PROFESSIONAL ASTRONOMER 29.95 f 
eae en Tae ec (PARTS ONE & TWO) neh e 
ADVENTURE CREATION TOOL SPECIAL EDITION ff Bsa saiciimiicaa ero eT ae 29.98 © 
PROFESSIONAL PUBLISHER : 89.95 c 
ACT is a must for every programmer, The name of the program Is misleading, Insofar as It FLICK CARD INDEX SYSTEM 29.95 a 
has capabilities far beyond the 'mere' creation of adventures. ACT has utilities providing ICK FRONT END SYSTEM 24.95 a 
c 
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Minimum 256K exp:either cartridge or disk 
Minimum 256K exp:only available on disk 
Available only on cartridge 


Send to: DIGITAL PRECISION LTD, 222 THE AVENUE, CHINGFORD, LONDON E4 9SE or phone 081-527 5493 
Please rush me: 


Postcode: __ 
Encl: CHEQUE/VISA/ACCESS/MASTERCARD/PO/MO/CASH for £ . 
Card No: Expiry:,... Signed: 


Delete as appropriate: (QUTHOR/STQL)(MDV/3.5"/5.25")(Disk=360/720/1440/2880/6400 sectors; nb 1 sector=0.5K)(If 720 sectors: SSDD/DSSD) 


C68 C 
Compiler 
Source 


When V3.00 of the C68 C 
Compiler was released, in 
June 1992, only the runtime 
disks were available. The 
Compiler has now been up- 
graded again, and the source 
code is now available. 

The Compiler is now ver- 
sion 3.01; some bugs de- 
tected in 3.00 were quickly 
put right by Dave Walker. 
The source code has been 
compressed onto two 3.5 
inch 720K disks. Disk 1 
contains a boot program 
which will load the Packer/ 
Un-Packer, a program called 
RamCopier for users with 
single disk drives and two 
of the compressed source 
code files. Disk 2 contains 
the remaining compressed 
source code files. 

C68 V3.01 Runtimes (3 
disks) £3 (pre-copied disks), 
£1.50 (user sup plies disks) 
postage & packing 50p 
(UK). C68 V3.01 Source 
Code (2 disks) £2 (pre-cop- 
ied disks), £1 (user supplies 
disks) postage & packing 
50p (UK). C68 V3.01 Full 
Issue (5 Disks) £5 (pre- 
copied disks), £2.50 (user 
supplies disks) postage & 
packing 5Op (UK). 

Orders and enquiries to 
QubbeSoft P/D, 38 
Brunwin Road, Rayne, 
Brain tree, Essex CM7 
5BU. Tel. 0376 347852. 
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Dutch Translation 
Help Wanted! 


Qubbesoft’s Ron Dunnett has a challenge - he wants a QL user to help translate Dutch software for the 
public good. “I have kindly been given loads of very good Public Domain software for the QL by the Dutch 
QL User’s group,” he writes. “The trouble is that most of it has Dutch text or _doc files, so I can’t put it out 
to English users, as they won’t have a clue what’s going on (unless they can read Dutch). Some of the 
programs are very good, and deserve a much wider audience.” 

Plus, says Ron, success might stimulate the authors to write more software in the future. He also has 
German software that has its text files which need to be translated into English from German. A previous offer 
of help from a user in Switzerland fell through when Ron sent him the files and heard nothing further! 

“I’m getting more and more software from Europe, for my public domain library,” says Ron, “And very 
little from UK users. I find this very odd.” 

Contact QubbeSoft P/D at 38 Brunwin Road, Rayne, Braintree, Essex CM7 5BU. Tel. 0376 347852. 


The Zike, Sir Clive Sinclair’s latest invention, is reported to be running behind its original production 
schedule. 

The electrically-assisted bike, which Sir Clive hopes will recoup some of the losses sustained by his 
previous vehicular venture - the CS electric car, unkindly compared by some to an electric bath-chair - was 
promised for the end of May. Customers who sent cheques for the £499 bike have been sent letters of apology, 
and will be given a discount when their machines are despatched. 

The Zike is now expected to be in full production in August. With a top speed of 15 mph, licence-free road 
use by anyone over 14, and a non-polluting power source keeping it ‘green’, the Zike may be heading for 
success. The failure of the C5 was blamed by many on unreliable batteries - slow speeds, users say, are no 
problem - but no speed is. Battery technology has advanced in the intervening years. 

Sir Clive blamed the delay to the Zike on problems with a production tool. The signs are, though, that Sir 
Clive’s fans don’t mind waiting a little longer. “I’m sure the Zike will get here,” said one. “I just hope he isn’t 
going to try and invent the Wheel first.” 


Dried to Distraction 


By the way, thank you to everyone who wrote to 
console us for the troubles we lived through earlier this 
year and saying how pleased you were to see us back. 
QOL World felt a bit like a ghostly swan during that time 
- nothing showing above the water, frantic paddling 
underneath! 

Apologies also to those who were baffled (or en- 
tertained) by some strange expressions in Mike Lloyd’s 
review of the Gold Card in the May/June issue. For that 
issue, we read nearly all the copy through an optical 
scanner. It was then swept with a spelling checker 
(note well - a very bad combination, if our experience 


is anything to go by) and then properly proofread. 

Unfortunately, under the pressure on our first 
Production Day, the pre-proof version of the file was 
imported onto the page. 

All OL World features are now read by the editor 
before they go onto the production computer. (With 
one or two small but notable exceptions which are 
still giving us gyp in the holiday season.) 

Meanwhile, we are still trying to work out what a 
hue memory is, how you roup a file, and why anyone 
should want to dry a disk. Suggestions to Open 
Channel, please. 
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POOLS PROGRAM 


WINNING 
THE POOLS! 


Businessman Stan Caton has pooled his QL re- based on mathematical analysis of the 
sources in the hope ofa win. David Drysdale reports. 


hen North Manchester busi 

nessman Stan Canton, now 

semi-retired, bought a QL in 

the machine’s early days, it 

was not a toy he was seeking 
buta professional machine capable of some 
very hard work. 

The work began the day the QL 
arrived, but it was Stan himself who had to 
doitas he laboured to program the machine 
with the help of the manual. His wife Maggie 
quickly became a computer widow as he 
would sit at the QL, on his days off, from 
5am until late evening and would have to 
be physically shaken out of his concen- 
tration to come away for a meal. 

There was one bonus for Maggie, 
though. Stan had always been an early 
riser who would waken the family by walking 
around at 5am. When the QL came he 
would go quietly to the keyboard as soon 
as he awoke and Maggie would get some 
peace. 


QL housing 


From the start the QL and its pe- 
ripherals took up too much workspace, so 
Stan designed a timber unit to keep it all 
together on the table top. It was probably 
one of the very first ‘workstations’ ever 
built, but Stan named it the Compu-cabinet 
and offered it for sale in QL User at £45. 
Only four people sent for itand so, naturally, 
Stan stopped making it. He still uses one of 
the cabinets which he has mounted on a 
foldable metal framed trolley so that it can 
be transported to demonstrations and ex- 
hibitions. 

Stan’s next venture on the QL was 
the design of a business cash flow chart 
which he developed with the aid of Maggie 
who was a professional bookkeeper. Again 
he advertised it with QL User, and this time 
he was more successful. The program had 
been intended in the first place as an aid to 
Stan’s own businesses and much im- 
pressed his bank manager. The QL User 
sales were a welcome spinoff. 

Stan’s varied business ventures in- 
cluded professional photography, kitchen 
designing and running a launderette, but 
whatever he was doing he found the QL 
was athand to help. When selling kitchens, 
for example, he designed a program that 
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would not only assist in designing the 
kitchen layout but cost up the job as it went 
along. 

This program so impressed a busi- 
ness colleague who was into bedroom 
furniture manufacture that he sought Stan’s 
help in developing a way of computerising 
his own price lists. 


Adaptable Abacus 


In his programming work Stan finds 
that Digital Precision’s Editor, along with 
the Turbocompiler, is an absolute must. Of 
the supplied software heis most impressed 
by Abacus, which he finds is amazingly 
adaptable and can organise business and 
accounts applications of every kind. He is 
also quite fond of Quill which he feels has 
been given anew lease of life with the Gold 
Card. He now uses front end program 
Qpac2 which, when eventually mastered, 
revolutioned his program and file handling. 
A PC-style keyboard completes his 
equipment. 

An important development for Stan 
has been the setting up of the Manchester 
Quanta group QUM. Prior to this everything 
he accomplished on the QL had been done 
the hard way by having to work through his 
problems alone and with only the manuals 
to help him. 

The group is now involved in im- 
porting public domain software from PCs 
into the QL and Stan has been quite busy 
assisting Sohail Bhatti of QLaw and the 
other members with this work. Again, Editor 
and Qpac2 have come to the rescue and 
Stan has written a program to automate 
processing of a full disk of files. 


Washed out 


All this QL activity is having a much 
needed therapeutic effect on Stan who 
some time ago had a traumatic time with 
the collapse of one of his businesses. The 
business, a very popular launderette on a 
council housing estate had been so busy 
that Stan decided to re-equip it with the 
latest and best machinery. 

This was no sooner done when the 
council handed the estate over to private 
developers who modernised the homes 


and installed washing machines in all of 
them! Not even the best of Stan’s sophis- 
ticated QL cash flow programs could save 
him from the financial meltdown that fol- 
lowed 

Stan, however, seemed quite un- 
perturbed by it all as he led me from his 
luxurious lounge overlooking a small forest 
of trees to his QL den to see his latest 
brainchild - a Football Pools odds-analysing 
program. There was nothing silly or mys- 
tical about it, he assured me, as it was 


methods of the only real pools experts, the 
Bookies, with the sole aim of increasing the 
winning odds. 


Fixed odds 


It is quite a sophisticated program 
and its development so far has convinced 
Stan that while it has a huge potential for 
increasing a punter’s likelihood of winning 
the Treble Chance it is a must for enthu- 
siasts who favour Fixed Odds coupons. 
They, he assured me, are likely to have 
even better results andshould see a steady 
profit from their pools investments. He has 
no intention of setting up as a pools tipster, 
he said, nor was he inviting the public to 
join him in some gigantic permutation. His 
aim was to develop, refine and degbug the 
program which would be offered for sale in 
a QL World advertisement. The punters 
would then be given a powerful tool with 
which to develop their own forecasting 
skills. 

As Stan, Maggie and | sat down with 
a cup of coffee Stan reminded me that the 
program had really been intended for his 
own use and he had great hopes of landing 
a good win with it. It would also be on 
exclusive offer, at the start, to owners of the 
QL. 


Just as there are people who have 
decided to stick with the QL because of 
programs such as Perfection, there will be 
others, | suppose, who will find that Stan’s 
new program will give them all the incen- 
tive they need to stay with the QL - the 
country’s “winning” computer. 
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SOFTWARE FILE 


QTOP 


Del Allen tries out the most recent 
version of QTop for the QL and Thor. 


INFORMATION 
Program: QTop 
Publisher: Cowo, Munsterstrasse 4 
CH-6210 Sursee, Switzerland. 
Available from: Software87 

33 Savernake Road 

London NW3 2JU 

Price: £29 


Top is a front end for the QL. A 
front end usually consists of a 
series of menus from which you 
can select various options 
intended to make life easier.For 
example, selecting Files will 
result in the appearance of a sub-menu offering 
various things to do with files, such as View, 
Delete or Execute. 

When QTop is booted, it 
helpfully decides which of its files 


have. Mem-Info lists a few of the Qdos system 
variables. Clocks presents a choice of clock 
types, both analogue and digital. These are fun 
to look at the first time. A large analogue clock 
face can be shrunk and placed in a corner of the 
screen. Some people may prefer this to the 
digital displays - I did. But I normally use a 
clock provided by Toolkit II. 

Snap is a screen dump utility. I have not 
tried this. QTop makes heavy use of the QJump 
Pointer Environment, which is a part of the 
package. The fact that the pointer environment 
is on the disk makes the package reasonable 
value for money. One could be forgiven for 
thinking that if one already has the pointer 
environment, there would be little point in 
purchasing QTop, but it has a few features that 


Pointer Environment then consider buying QTop. 

The manual is very well written 
considering its foreign origin - itis much better 
than many English manuals, though it lacks an 
index. As a bonus it includes details of the 
hotkey and TKII commands. It is extremely 
pleasant to have these all together under one 
cover. 

The rest of the QTop package should be 
regarded as a bonus. There are a lot of demos, 
intended, presumably, to impress with their 
speed. Sadly, visually, they are largely 
unimpressive. The sight of coloured blocks, for 
example, appearing and disappearing with 
extreme rapidity very quickly becomes boring 
and will not impress, say, Amiga owners. One 
or two, though, are quite pretty. The animation 

demos are a bit uninspiring, as one 
cannot do anything with them other 


to load, after checking the rom 
type and the amount of memory. 


The user merely has to insert the a. 


QTop—DESK 


disk and press a key to inform the 
program which computer is in use 


- QL, Thor, Amiga etc. After a 


as listing all jobs, suspending a 


job, and so on. 
Yet another option is 
Myprogs. This will present you with 


: Jobs 

short wait the Main menu appears. : = "i. ! 
Here is an option to alter the default iF 5 ST JOBS ay oe Cr ICEL see os 
devices. For example, one can | OWN PRIOR Ls: ee dan 
specify that, say, flp2 is to be used : #20200 @ (127 TOESK 
for data and flp1 for programs. / Cee RRL 
Another option calls up a jobs HOLD Kvdce at ef tae 
manager. Poe asiog 7G 38 TOP 

Here one can do such things : ' ee CANCEL - - 

g 


than watch. But they are not part of 
the Qtop system and should not be 
criticised too heavily! 


Different speeds 


The last item, Tindex, is 
different. It purports to show 
differences in speed in various 
operations between a standard QL 
and your system, and as such is 
interesting and informative. Itshows, 
for instance, that a QL with a 512K 
Expandaram is slightly faster than a 
128K QL, as one would expect. I was 
surprised to find, however, that disk 
handling was significantly slower. 
Upon querying this with the author, I 


a list of programs, provided that 
you have previously created the 
list. The method of creating a list is somewhat 
inconvenient, and the list itself is of doubtful 
use. The Tools option presents a few basic 
utilities such as hex to decimal conversion. 
Options allows changing baud rate among other 
things. 


Unforgettable 


Desk puts you into the Desk menu. Here 
you can remind yourself of which solid colours 
are available. If you have forgotten the colours 
in mode4, for example, you will see four bands 
of colour viz black, red, green and white. This 
is not something I forget very often. System- 
Info will tell you things like which rom you 


make use of the pointer environment easier and 
this alone, I believe, makes QTop a reasonable 
buy. 

For instance, QTop somewhat eases 
button handling. A button is a little window 
with a program name in it. The button can be 
easily created and can be used to put a program 
to ‘sleep’, wake it up, and so on. 


Curate’s egg 


As I intimated earlier, while there are 
some features that I could live without, QTop 
also has its good points - it’s a real curate’s egg 
in fact. If you do not already own the Extended 


was informed that Tindex should be 
run onan ‘empty’ machine. It did not 
and does not say this in the manual. To run 
Tindex onan ‘empty’ machine it is necessary to 
load up an extension file. I have copied Tindex 
and the extensions to a separate disk and have 
had a lot of fun trying different Lightning 
settings. But Tindex still tells me that disk 
handling with the Expandaram is slower than a 
standard QL with microdrives!. 

To sum up: forget about the demos - they 
are free, anyway. The QTop system itself is 
worth having if you need a front end and do not 
already have the Extended Pointer Environment. 
A small proportion of its features are of limited 
usefulness, but the system as a whole may 
make a useful addition to your roster of working 
programs. 
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PEN WHANNEL 


Open Channel is where you have the opportunity 
to voice your opinions in Sinclair QL World. 
Whether you want to ask for help with a technical 
problem, provide somebody with the answer, or 


just sound off about something which bothers you, 


write to: 


Open Channel, Sinclair QL World, The Blue Barn, 
Tew Lane, Wootton, Woodstock Oxon. OX7 1HA 


Could you please let the scepti- 
cal know that the pirated Minerva 
does exist - I bought it at Miinster! 
They guy selling it was apparently 
too uninformed to realise it wasn’t 
genuine. It was a very early 1.66, 
and didn’teven work without much 
tweaking. It was no April Fool. 

On a slightly different tack, the 
eprom in the MKII Minervas (the 
real time clock, etc.) is identical to 
the MKT. It is worth pointing out 
that the Minerva clock is only 
connected to the QL by a serial 
bus. The protocol for changing 


this clock is extremely compli- 
cated, and QL crashes will not 
corrupt the clock, unlike all other 
QL clocks, including the memory- 
mapped Gold Card clock. In fact, 
we recommend users of both to 
unplug the Gold Card battery. It is 
possible to crash the Minerva clock 
when the device is being trans- 
ported outside the QL. If yours 


becomes corrupted, then 
EXEC_W the program 
MINICONFIG_OBJ to 


reconfigure it. Minerva MKII 

needs version 2.26 of the Gold 

Card, or greater, to work properly 
with it. 

Tony Firshman 

TF Services 


London W2 


HeeHaASeEHE 


Editor’s notebook 


Activist Ron Dunnett (Qubbesoft, Quanta) has 
been looking for help in translating the text of 
German and Dutch public domain software into 
English, (see QL Scene), but so far even such 
offers as he has had have not borne fruit. It 
seems a pity that these programs should be 
under-utilised because of language barriers. 

We hear that Sir Clive Sinclair’s Zike bike is a 
little behind its production schedule. If it runs 
true to form, it should still have a strong followng 
in anumber of years, just like the Spectrum and 
the QL. 

Agentleman in Scotland who reads The Beano 
compares our correctness unfavourably with 
that venerable journal. | should hope so. The 
Beano’s publishers are fierce in defence of their 
honour, and | would be proud to know the 
proper form of the word OYAAH, but my dic- 
tionary, alas, doesn’t seem to include it. 

Spare a kind thought for Mike and Sue Lloyd, 
moving house (they very much hope - “we are 
still on a knife-edge”, says Mike) in these trou- 
bled times. And a thought for all the folk who 
can’t, too. 
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Driven 


I thought I had printer drivers 
licked. My printers have been 
working fine for several years now. 
Then, for quickness, I decided to 
print a draft copy of a two-page 
document from Quill onto my 
Brother M1109 printer. Horrors: 
each time the download to the 
printer was completed, it printed 
the last few lines of the page, and 
then continued with the rest of the 
document. Also the out-of-place 
lines were offset to the left, ig- 
noring the margin setting. 

I’ve tried juggling the printer 
codes in the driver, such as mak- 
ing the page length shorter than 
that set in Quill, but to no avail. 
Can anyone suggest what the 
problem is? Since I mainly use my 
DxX-100 for printing documents, 
it will not hinder my work, but I 
am curious as to why the M1109 
refuses to print multi-page docu- 
ments without messing up the 
print. 

James C McGreehin 
Alva 
Scotland 


Editor’s comment: This is just 
the sort of query that, were all our 
files in order and the many kind 
offers of help with printers that we 
had last year easily to hand, I 
should be able to pack off to a 
responsible party. For now, any 
responsible party with a answer 
for James, please write to Open 
Channel. 


Unblocked 


Referring to my article Three in 
the Hand, over which there was 
some controversy, Ishould explain 
how I arrived at my block-move 
timings for the three programs. I 
was using version 2 of Perfection 
at the time I wrote the survey. V3 
is faster, but this is not the main 
point. 

John Bunce (QL World July 
1992) was wrong - I did not forget 


any decimal points. Perfection can 
move massive blocks of text for 
miles and miles almost quicker 
than the average giraffe can blink. 
Nevertheless, it took this user, to 
the nearest second averaged over 
three similar attempts, 25 seconds 
of total user time, not just the text- 
move itself, to move one para- 
graph one page lower. All three 
programs, as the article stressed, 
performed more than adequately. 
This is the process I used: I 
began timing with the cursor at the 
start of the block. With Perfection, 
you highlight the following text, 
move the cursor to the end of the 
block, mark the end of the block 
(by unhighlighting), define the 
highlit area as a block, move the 
cursor to where you want the block 
to go, and then move the block. 
This takes time. To avoid clumsi- 
ness, I practised with each word- 
processor, and the final figure is 
the average of three efficient tests. 
Michael Edwards 

St Mellons 


Editor’s comment: Since this is 
the type of program to which Per- 
fection is often compared, I tried 
the same move on one of our 286 
machines running the most recent 
version of a well-known MS-DOS 
wordprocessor. 

Going through the same se- 
quence - that is, starting with set- 
ting the block - to move a 10-line 
block from top to bottom of a large 
file took 55 seconds. 

This was longer than I had ex- 
pected! And then I had to move it 
back again. The bulk of the time in 
this example was the actual file- 
moving. 

To move afour-line block down 
ten lines took about 15 seconds. In 
this example, the file-move time 
was virtually instantaneous. 

You can see by comparing these 
figures what proportion of the time 
(about .25 of a minute, assuming 
the user can see exactly where the 
text is to be placed and does not 
have to go looking for it) was 
taken up in setting the block and 
moving the cursor to the destina- 
tion position. 
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Perfection uses one more proc- 
ess (defining the block) than my 
test-piece, but moves the block 
faster over long distances. An- 
other well-known MS-DOS 
wordprocessor, for instance, 
moves its blocks faster than my 
test-piece, but also has a longer 
defining sequence. Youwins some, 
you loses some. This is the ball- 
park that a powerful word proc- 
essor is operating in. 

This is a realistic way of assess- 
ing block-handling. Although fast 
file-handling is one of the greatest 
blessings, in a complex operation 
like block-handling, the text- 
marking and locating times should 
be included, as has been done 
here. 

There have been updates of two 
of the three programs surveyed in 
Mike’s user report since he wrote 
it. All three programs were ver- 
sions which were on sale to the 
public and being used in earnest, 
and not beta-test or preview 
models. 


I have seen the article System- 
atic Machine Code Programming 
starting on page 45 of the April 
QL World. 1 was surprised to find 
Alan Bridewell advocating a busy 
wait, that is, a tight loop doing 
nothing with, I suppose, the in- 
tention of allowing other jobs to 
use the processor! The job doing 
the waiting is, of course, still us- 
ing cpu time, which other tasks 
might want. Also, the delay de- 
pends not only on the number of 
times the loop is executed, but on 
the processor speed (Gold Card, 
etc.), memory expansions, what 
other tasks are running, and so on 
as well. What he should have been 
using is the Qdos call specifically 
for this purpose: MT.SUSJB, 
which suspends (pauses) a job for 
some fixed length of time allow- 
ing other jobs to run. Something 
like this: 


-keyrow 

moveq #$8,d0 ; Code no. for 
MT.SUSJB 
moveq #-1,d1 
job 

moveq #2,d3_ ; Time in units of 
1/50 sec 

moveq #1 ; Do it 

; Now the keyrow routine proper 
lea keyr,a3 ; Keyrow param 
table 


; Suspend this 


And so on. A similar change 
should be made to the other two 


Sinclair/QL World September 1992 


routines. Also, in the keyrow rou- 

tine as printed, the loop jumps back 

to initialising the counter rather 

than the NOP instruction, giving 
an infinite loop. 

Ian Jackson 

Ponteland 

Northumberland 


Alan Bridewell replies: Mr 
Jackson is quite correct. The best 
solution is to suspend the job to 
prevent excessive calls to the IPC. 
Why I didn’t think of that at the 
time is beyond me - my only excuse 
is that lama self-taught program- 
mer, such mistakes are bound to 
crop up eventually. However, I 
must add that the tight loop does 
work. Although it wastes valuable 
processor time, it wastes far less 
than accessing the IPC several 
times in one keypress! And if it 
works, I tend to use it. But in future, 
I shall use MT.SUSJB. 

He is also correct in pointing 
out that the Keyrow routine as 
printed does not work. Unfortu- 
nately, I sent an early (bugged!) 
version to QL World for publish- 
ing, instead of the final version. 
Please accept my apology for this. 
Note, however, that the sample 
program which uses the routines 
does work, because it contains the 
correct version. I do try to test 
everything. I actually compile the 
output from the word processor 
for the articles, to check the pro- 
grams! This, of course, won’twork 
for the separate routines, because 
even if they compile, they won’t 
run as programs. 

The Editor adds: Alan has pro- 
vided two sheets of updated listings. 
Users who would like a copy of 
these listings, please send an SAE 
to the Arcwind office and I will 
arrange for copies to be sent. 


Mr. Freddy Vachha of Digital 
Precision has been in touch with 
me and spent a long time trying to 
analyse a fault which has been 
giving me trouble with some pro- 
grams. We have jointly come to 
the conclusion that it must be either 
my disk drives, or the Trump Card/ 
interface which is at the root of the 
problem. He has asked me up to his 
office together with my ‘kit’ for a 
health-check/MOT (for the kit, that 
is), hoping that we may once and 
for all sort out the problem. I shall 
take up his offer when time allows. 

Michael J Grover 
Leatherhead 
Surrey 


Early Model 


I own an early Sinclair QL, se- 
rial number D12-063456, and I 
understand that this machine may 
have problems with some printers. 
Can anybody recommend to me a 
good printer which will work with 
my machine without too much 
messing around? 

K W Blackmore 
Stamshaw 
Hants 


From time to time I have read 
that Psion Chess will not work 
with a memory expansion. The 
latest mention appears in QL World 
in Mike Lloyd’s review of the Gold 
Card in the June 1992 issue. 

Thave a 640K QL, and I find that 
Psion Chess operates perfectly 
using the boot program listed here. 
This boot program must be on the 
same medium as a copy of the file 
‘chessc’ supplied by Psion. The 
original mdv cartridge must, as 
always, be in mdv2 at run time. 

Mdv users should change flp1 
to mdv1 in line 160 of the listing 
here. 

No special toolkit is required, 
and the system runs satisfactorily 
on JM and JS roms; probably on 
others, too. 

CB Storey 
Tyne and Wear 


Comment: Thanks to Brian and 
other Psion Chess players who 
commented on this. 


Boot program for Psion Chess 


100 MODE 4 

110 OPEN 
#1,con_512x256a0x0_32:CLS 
120 CSIZE #1,1,0 

130 CSIZE 3,1:AT 
2,12:PRINT’QL CHESS” 

140 addr=184064 

150 a=393216 

160 a=RESPR(a-addr) 

170 LBYTES flp1_chessc,addr 
180 CLOSE #0:CLOSE 
#1:CLOSE #2 

190 CALL addr 

200 STOP 


Head Left! 


Referring to A R Kempton’s 
problem with his printer: to get the 
printer head to return to the left 
hand end of the printer, he must 


include the following in his 
printer_dat: 


PREAMBLE ESC@ 
POSTAMBLE CR 


Those are, respectively, a printer 
reset and a carriage return. 

The latter is required because, in 
Quill, if he leaves the cursor at the 
right hand end of the last line, then 
the last line will not be printed but 
will appear at the top of the next 
document he prints. 

If, however, the Taxan printer is 
not Epson-compatible, he must 
read the Taxan handbook to get the 
appropriate equivalent codes. 

A Owen 
Stowe by Chartley 
Stafford 


Re A R Kempton, Open 
Channel, QL World July 1992, 
he should check that his printer 
driver has a CR character (code 
10/10) included in either/both 


of the PREAMBLE and 
POSTAMBLE strings. 
Chas Dillon 
Tamworth 


Like your subscriber A R 
Kempton, I had trouble with my 
printer (a Brother HR-15) not re- 
turning to the left-hand margin at 
the end of a document, and then 
starting the next one in the wrong 
place. 

After exhausting my meagre 
store of technical knowledge 
to no effect, I decided to try 
guile. 

My first cure was to put a 
full stop on a new line at the 
end of each document, and this 
of course caused the carriage 
to return there, but now I just 
leave a blank line at the top of 
each document and, wherever 
the carriage is, it moves back 
to start the second line as 
shown on the screens. 

For the same problem with 
printing from Archive Database, 
the alternatives are to incorporate 
LPRINT as the first line of each 
PROCedure, or when necessary to 
type LPRINT “ “before calling the 
procedure you want. 

I hope this helps. 

T Rendall Davies 
London N21 


Comment: Conventional and 
less conventional solutions there, 
which I hope will give assistance 
in both directions. The trouble with 
guile is that it can provoke coun- 
ter-guile from your machine in 
some unexpected places. 
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In Part 2 of his Aba- 
cus spreadsheet, 

P H Warne shows 
how to deal with 
payments that don’t 
occur every month. 


ast month you started laying out 

the spreadsheet which prom 

ises to solve all the problems 

you have with your bank account 
- except how to keep it topped up! 

The formulae arriving at the latest 
payment date for quarterly and biannual 
payments proved the most difficult to 
compile. The principle used is to calculate 
the offset from a 3,6,9,12 sequence for 
quarterly payments (or a 6,12 sequence 
for biannual payments) for both the current 
date and the standing order date. The first 
offset is then deducted from the current 
month and the second added to it. A fur- 
ther 3 (or 6) is deducted if the second offset 
is greater. The complications arise when 
that takes you into the previous year, and 
Abacus comes up with a date like 1991/00/ 
03! It took a long time to sort that one out. 

Table three gives the formulae to 
be entered. Two more constants for the 
current date are added to the table in 
column Al - the offset of the month from a 
quarterly anda six-monthly sequence. The 
formula in column C calculates the offset 
of the first payment date, adding 3 (or 6) if 
the offset is zero and the number of the 
current month is less than 3 (or 6). Column 
E assigns a value of 9 (or -6) if conditions 
are such that the most recent payment 
would be in the previous year, 3 (or 6) ifthe 
offset in column C is more than that for the 
current date, or zero. As with the monthly 
payments, both columns assign a value of 
15 if the current date is outside the limits 
one side or another. Column F combines 
the offsets with the number of the current 
month, subtracting 1 from the current year 
if necessary, to arrive at the date of the 
most recent payment. The formula in the 
monthly columns | to AG is the same as for 
monthly payments, but it is only entered in 
those columns which would apply to that 
particular payment. For example, for a 
quarterly payment first due in February, 
only the monthly formula in the February, 
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Abacus: only 
following orders 


TABLE 3 - variants for un-expanded GL 


"Flag" column D omitted. 


month ((col (3-6) /2) 


Monthly#— 


+Bxx(8 to ))) 
Quarterlyt- 
In column Cr- 


(&@ to ))/3))#3+0.1)) 
In column Er- 


Bi-Annualt- 


Annual t- 
Bnni 


if (SAF 4 s=days (Bxx 


where Mn=number of month 


E is 


May, August and November columns 
should be copied. 


Weekly intervals 


It is also possible to cater for credits 
or debits due at weekly intervals, or at 
intervals in multiples of a week, but these 
are treated differently. For simplicity, the 
total amount covered by the period be- 
tween the date of first payment and the 
current date is shown in the January col- 
umn. Although it is possible to break this 
total down into monthly sums, the formu- 
lae are all very long and in some columns 
Abacus has to be forced to accept them by 
subterfuge! It was felt that the end did not 
justify the means. The date of the first 
paymentin the current year is calculated in 
column F. The two formulae are shown in 
Table four. 

When the basic spreadsheet has 
been drawn up, any of the formulae for 
regular payments which are also required 


Date Constants will be in column AF. 
Formula in H3 (month headings) etc.» will ber- 


Formulae in columns © (Quarterly only) & E (Latest 


Payment/Debit) will ber 


if ($AF4<days(Bxx)>Bxxs if (AF 4e=days(Dxx)»DxxsBxx( to 5+ 
str (BAFS-i f ($AFS<val (Bxx(% to ))2120)4+100,2:0)(2 to ) 


if (SAF 4<days (Byy) +15, int ((val (Byy(@ to ))/3-int (val (Byy 


if (Cyy=15. Byy. i f ($AF4>=days (Dyy);Dyy:Byy( to 5)+str ($AFS 
-$AF7+Cyy-i f (Cyy>$AF7 or ($AF7=Cyy and $AFé<val (Byy(7 to 
¥)53:0)4+100;2,0) (2 to )+Byy(8 to ))) 


if (SAF 4¢days(Dzz)»Bzz:Dzz) 
Formulae in Monthly columns will bet- 


and val (Bxx(é to 
(6 to ))e=MnaFxxs"----- um) 


If weekly credits/debits are required: 
"“Bxx" and the formula in column H is amended. 


)}<=Mn and val (Exx 


the formula in column 


in the Credits section can then be copied 
up. In Figure one, you will see that this 
has been done for the monthly payments. 
The whole ‘block A17:AGO was copied to 
cell A5 and the textin cells A5, F6 and A7 
edited. However, biannual credits must 
not be above row Q, to avoid forward 
referencing. 

The next thing to do is make a list of 
all your standing orders or direct debits, 
andthe dates and amounts involved. Some 
standing orders will need two or more 
rows allocated to them. For instance, as 
Figure two shows, Poll Tax starts with 
two payments from the previous year’s 
assessment, then a single payment in 
April followed by nine others for a lesser 
amount. The second row shows the same 
date in both columns for the payment of 
the initial sum and the third row shows the 
dates of the first and last subsequent 
sums. Almost certainly, more than one 
row willbe needed for mortgage payments 
to allow for changes in interest rates. 
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Accommodation 


Toaccommodate allthese payments, 
expand the spreadsheet by inserting as 
many rows as are required for each category 
of payment (or credit). Note that rows are 
inserted above the cursor position or the 
row number typed. TO do this, place the 
cursor in the desired row and type F3 G | 
Enter nn Enter Enter. All the formulae are 
adjusted automatically, so provided the 
summation formulae include the sum un- 
derline row, any inserted rows will be in- 
cluded in the totals calculated. 

When the rows have been inserted, 
use the Copy command to copy the data 
and formulae in the top row of the section 
to the row below, by typing F3 C Bn:AGn 
Enter Bn+2 Enter), repeating the process 
as often as necessary to fill in the inserted 
rows. Then fill in column A and enter the 
correct dates and amounts in place of the 
dates so copied. For payments other than 
monthly, the formulae in cells Ixx to Agxx 
are only copied in the columns where a 
payment would fall due, and not across the 
whole row. Figure 2 shows how the fin- 
ished product should look. 

Because the Insert and Copy com- 
mands make it simple to insert a row when 
needed, there is no need to leave empty 


! fi eae itr 0 
LIBANK ACCOUNT #1234578 - A.N.Y. BODY 
ZIACCOUNT FOR YEAR 1991 
3} DATE!- = -3/12/91 

' 


Sel i 
For current Balanci 


H 
SISTANDING CREDITS#- 

6t Start date: 
TIMONTHLY # = 

'Pension Fund L9PL/OL/16 # 1991/03/16 # 1991/03/16 
ut 1994/04/16 # 1992/03/16 1991/11/16 
101 


ist/Latest 
Creditt 


Last datet 


OTHER CREDITS!~- 


STANDING ORDERS & DIRECT DEBITS!~ 
Start date! Last datet 


{st/Latest 

Payment? 
1. MONTHLY! - 

19iNcle & G'd Water 1991/05/01 

1991/06/01 

Building Society 1990/10/03 

. 1991/04/03 


1991/05/01 # 1991/05/01 
1991/12/01 # 1991/12/01 
1991/03/03 # 1991/03/03 
1991/07/03 # 1991/07/03 
1991/08/03 1992/01/03 1991/12/03 
1989/04/03 1999/03/03 1991/12/03 
1989/07/14 # 1993/03/14 1991/11/14 
1990/06/29 # 1991/02/29 # 1991/02/29 
1991/05/29 # 1991/05/29 # 1991/05/29 
1991/06/29 # 1992/02/29 1991/11/29 


24iScottish Life 
25/H.F.C Trust 
261Poll Tax 

271 

28) 

2912. QUARTERLY: - 
3OIBr. Gas Service 1991/02/11 2 1994/11/11 # 1991/14/11 
3113. BI-ANNUAL:~ 
32{0x fam 

3314, ANNUAL! 
B4iUnion Subscrip’n 1970/01/31 
35iNational Trust 1990/09/28 
3b 
S7ICHEQUES (Payee and/or Number) #- 


1989/03/01 3 1993/03/01 6 1991/09/01 


1995/01/31 
1995/09/28 


1991/01/31 
1991/09/28 


Figure 2 - specimen completed account. 
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Balance Brought Forward$----~ 


£141 31 
£126.43 
£113.66 


TOTAL DEBITS#- 


rows to allow for future changes. 

Cash withdrawals and payments by 
cheque or card transfer should be entered 
in the appropriate monthly columns below 
the standing payments. Itis easy to getinto 
the habit of doing this at regular intervals. 
Itis not necessary to calculate the balance 
on every occasion. 


Five seconds a row 


Calculation, using the F3 X com- 
mand, takes a few minutes (about five 
seconds per row for those with the full 
standing payments formulae). On typing 
F8 X, you are asked for the date for which 
the balance is required. This is in the usual 
English format D(D)/M(M)/YY, which is 
converted for Abacus use in cell Al3. To 
view the balance go to cell AExx in the last 
row (F5 AExx). 

The formulae in the totals cells make 
itpossible to obtain ‘end-of-month’ balances 
for any month, ignoring credits and debits 
which have been entered for subsequent 
months. This makes for easier comparison 
with bank statements, which are usually 
sent out at the end of the month. In fact, it 
would not be too difficult to add Nigel 
Bates’ reconciliation procedures atthe end 
of the sheet, to make comparison with the 
bank’s statement even easier. Make a list 


5 — 


ego to cell AEA5 


January February 


358.84 


Amount! 


466 37 
590.34 


466.37 


TOTAL CREDITS!~ 


Amount? 


£23.82 
£23.77 
141.31 


£25.76 
£35.35 
£31.20 
£28 8? 
£28.50 


£17.35 
£40.00 


£14.00 
£38.00 


14,00 


Cash 5/1 
BPOPB 8/1 
B'card 370 
Cash 23/1 


150.00 BPOPB 6/2 
15.84 Cash 6/2 
34.30 B’card 371 

250,00 B.S.S. 372 

Cash 16/2 


7 .b4 
200.00 
45.00 
2.00 


23.56 
100,00 


£697.76 £525.61 


120.00 Cash 2/12 


ABACUS 


of the cell references for payments not 
shown in the bank’s statement, and type 
these references into the appropriate 
section of the reconciliation. 

At the end of the year, it is only 
necessary to change the year in cell B2 
(remembering that this is text), transfer the 
balance calculated for 31 December to the 
‘Balance Brought Forward’ cell (14) and 
delete any rows covering payments which 
ended in the past year and are no longer 
relevant. 


Limited ram 


For those with limited ram, all dates 
must be quoted in terms of the current year 
and only the twelve monthly columns used. 
Flag column C is retained but only used for 
quarterly payments. The formula in column 
E showing the most recent payment is 
altered accordingly. In the monthly columns, 
beginning at H, the comparison need only be 
between the number of the month and not the 
days of the whole date. The main alterations 
are shown in Table five. There will also have 
to be adjustments to text in some places to fit 
into the reduced space. 

Memory can also be saved by de- 
leting any parts of a row beyond the last 
month in which a payment will appear, 
that is, beyond the month of the final 


fH ot Al 
DATE CONSTANTS? 


Pigs = 


1991/12/03 


YEAR 1992 


December January 


+ 


£7686 .65 


100.00 


£263.19 £7493 46 


BALANCE ON 03/12/1991 


SOO  — ss ee 


ABACUS 


payment. Since that row will be deleted 
entirely at the start of the next accounting 
year, no problems will occur when the 
new year is opened. Doing this will also 
speed up calculation a little. 


If the whole spreadsheet is printed 
out in condensed type (137 characters per 
line), it will occupy three A4 sheets. With 
the monthly text columns only 10 charac- 
ters wide, there is a margin on the right 


hand side of the third sheet. There is, 
therefore, scope for increasing the width of 
these columns without taking up more pa- 
per, but the information on-screen at any 
one time would be reduced. 


i a oe igh oD IESE re FG aa 
LIACCOUNT #12345678 
ZIACCOUNT FOR YEAR 1991 
3 DATE!- 26/9/91 
4 
5 


Balance Brought Forward: 
ist/Latest 
Credits 


STANDING CREDITS 
6} Start Date! Last Date: 
7 MONTHL YE = 
oi 
SIQTHER CREDITS!- 


Amount? 


1990/01/01 1995/01/01 1991/09/04 50.00 


li 

12] 

131 

14} 

151 

16! TOTAL CREDITS:- 
A7ISTANDING ORDERS & DIRECT DEBITS ist/Latest 
18} Start Date! Last Date: © Payment: 
1941. MONTHLY: ~ 5 
20! 1990/01/01 
2112. QUARTERLY:- 

221 1990/02/01 2 1995/02/01 3 1991/08/01 50.00 
2313. BI-ANNUAL! 

24} 1990/06/01 
2514, ANNUAL! 

261 1990/01/01 
271 QTHER DEBITS:- 

281 

291 

30} 

34} 

321 

33} 

34} TOTAL DEBITS!- 
351 

36! 

37iFigure 1 - the basic spreadsheet. 


Amount? 
1995/01/01 1991/09/01 50.00 
1995/12/01 1991/06/01 50.00 


1995/01/01 1991/01/01 30.00 


Rom Switch from 
QLEA only 


“A small but very significant error” has crept, 
according to Quanta, into July’s “otherwise ex- 
cellent” report of the Bristol Quanta Workshop. 

The Minerva/QL Rom Switch was mentioned 
in the report as being available from Qlas. 

Syd Humphries stresses that the Switch was 
designed by, and can only be obtained from, 
QLEA, the Quanta East Anglia Subgroup. 

The Switch costs £25 plus £1 postage (£2 
outside the UK and Europe), from QLEA, c/o 
Geraint Jones, 1, Bridgate Court, Thetford, 
Norfolk IP24 3AY, UK. Payment by sterling 
cheque to QLEA. 

Syd sends his best wishes to OL World. 


For current balance, go to cell AEx 


January 


DATE CONSTANTS: 

YEAR 1992 
January 1991/09/26 
149287 
9 
2 


Februa, November 


3 


BALANCE ON 26/09/1991 


Quanta organiser 
solves two in one 


A Quanta workshop is being planned in Kent for 5/6 September 1992. 
The Venue is the Swan Hotel, Ashford Road (the A20), Charing, Kent. Tel. 
0233 712357. Overnight accommodation is available there and nearby. 
Bar and refreshments will be available. The organiser is Paul Merdinian, 
Forge House, Charing Heath, Ashford, Kent TN27 0AX. Tel. 0233 712857. 

Paul is launching his program QL Super Crossword Solver on the Mardi 
Computers label at the workshop. Supplied on 3.5in disk and designed to 
“work on any QL, even a 128K base model”, the program “works like 
electronic spellcheckers, accepts input of known characters and ? for 
unknown, and utilises controlled scrolling.” The software also apparently 
includes “Forty programs, twenty in SuperBasic, for you to hack to your 
heart’s content, and 20 superfast stand-alone compiled versions. Contains 
over 20,000 words.” The program costs £10 inclusive of UK postage. 
Enquiries to Paul Merdinian at the address above. 
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Rates (12 months) 


U.K. £23.40 
Europe: £32.90 
Rest of World £40.90 


Cheques should be made payable to Arcwind Ltd. 
Please debit my credit card/Access/Visa 


SUBSCRIBE TO 
SINCLAIR QLWORLD! 


SUBSCRIPTION FORM 


Select back issues available on request. Please call for details. 


Send the completed form to: 


Arcwind Ltd 
The Blue Barn, 
Tew Lane 
Wootton 
Woodstock 
Oxon OX7 1HA 


Card No. 
Expiry Date 


Tel: 0993 811181 


Name 


Please send me a 12 Month subscription to Sinclair QL World 


Fax: 0993 811481 


== 


Address 


Telephone No. 


Signed 


Date 


QUANTA 


Independent QL/Thor Users Group 


Worldwide Membership is by subscription 
only, and offers the following benefits: 
Monthly Newsletter — up to 40 pages 

Massive Software Library — mostly FREE! 

Free Helpline and Workshops 
Regional Sub-Groups. One near you? 

Advice on Software & Hardware problems 
Discounts from most major suppliers 
Subscription just £14 for UK members 

Overseas subscription £17 


Barclaycard: Visa: Access: Mastercard 
* Now in our NINTH successful year * 
Further details from the Membership Secretary 


Bill Newell 
213 Manor Road 
Benfleet 
Essex. SS7 4JD 
Tel (0268) 754 407 


IF AN ADVERT 
IS WRONG, 
WHO PUTS 

IT RIGHT? 


We do. 

The Advertising Standards Authority ensures 
advertisements meet with the strict Code of Advertising 
Practice. So if you question an advertiser, they have 
to answer to us. 

To find out more about the ASA, 


please write to Advertising Standards 


Authority, Dept. X, Brook House, 
Torrington Place, London WC1E 7HN. 


This space is donated in the interests of high standards in advertisements. 


16MHZ 68000 
HIGH SPEED 
PROCESSOR 


DD, HD, ED, 
DISK 
INTERFACE 


BATTERY 
BACKED 
CLOCK 


QL GOLD CARD 


£225 inc. (£200 export) 


This is the expansion that has been revolutionising the QL. It is very easy to fit - 
it simply plugs into the expansion port at the left hand of the QL - and once fitted 
it will instantly increase the execution speed of the QL by about 4 times due to 
the presence of a 16MHz 68000 on board. There is 2M of fast 16 bit RAM of 
which QDOS sees a contiguous 1920K. The remainder is used for shadowing 
the QL’s ROM and display memory and for the GOLD CARD’s own code. 


There is a disk interface which can access 3 mechanisms (4 with the DISK 
ADAPTER) of 3 different densities, DD (double density, 720K), HD (high density, 
1.44M) and ED (extra high density, 3.2M) in any mix. The disk interface 
connector is the same type that was fitted to the TRUMP CARD so most QL 
compatible disk drives can be used. Please note that DD drives still give a 
capacity of 720K per diskette. Our DUAL ED DISK DRIVE allows the GOLD 
CARD to access DD, HD and ED diskettes. 


Another feature is the battery backed clock. When the QL is switched on the 
contents of the clock are copied into the QL’s clock so that the time and date are 
correct. The firmware in the ROM gives the GOLD CARD all the functionality of 
the TRUMP CARD like TOOLKIT II and there is a sub-directory system for 
floppy and RAM disks. 


Physically the GOLD CARD is about half the size of the TRUMP CARD and so 

fits almost all within the QL. Its current consumption is well under the allowable 

maximum so no special power supply is required. The GOLD CARD comes with 
a 14 day money back guarantee and a 2 year warranty. 


CUSTOM 
LOGIC 
CHIP 


MIRACLE 


2M BYTE 
RAM 


SYSTEMS 


BOX OF 10 ED 


DISKETTES 
£30 inc. (£30 export) 


Ten 3.5" ED diskettes. Gives 
capacity of 3.2 MBytes when used 
with GOLD CARD and DUAL ED 
DISK DRIVE. 
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DISK ADAPTER 
£15 inc. (£15 export) QL CENTRONICS 


£25 inc. (£25 export) 


Plugs into TRUMP CARD or GOLD CARD to 
allow access to 2 dual disk drives (i.e. 4 Connects SER1/SER2 to 
mechanisms) as FLP1_, EEP2_, FLP3_, FLP4_. Centronics parallel printer. 3 
metre cable included. (D9 
serial plug option for German 
and American QL available.) 


DUAL ED 


DISK DRIVE 
£175 inc. 
(£155 export) 


Two 3.5" ED mechanisms, power 
supply and cables. Connects with GOLD 
CARD to read/write/format DD/HD/ED 


diskettes. Includes 10 ED diskettes. Te 
AUS eit 


Tel 5 (0904) 423986 r To: MIRACLE SYSTEMS Ltd, 25 Broughton Way, Osbaldwick, 


i) 

1 
To place an order by phone York, YO1 3BG, U.K. Tel: (0904) 423986 
please have your credit card _| Please sendme 
I 
1 
I 
1 


ee For ee Es cps a | enclose a cheque to the value of: £ 

we charge the prices shown in ! 

brackets. | Or debit credit card | 
To order by post, please fillin Expires [T ]/L1 1 


the form opposite or write to; 
us quoting your credit card 
number and expiry date, or =! 
enclosing a cheque payable to | 
MIRACLE SYSTEMS Ltd. —— a SUSI SSS CaS Sa SSS SS SS ww SS ESE 


Name Signature 
Address 


SOFTWARE FILE 


INFORMATION 

Program: Qdesign | running under the Pointer 
Environment (included). 

Publisher: Jochen Merz Software, Imstillen Winkel 
12, D-4100, Duisberg 11, Germany. Tel. 010 49 
203 501274. 

Price: Qdesign 2 recently released: £48, including 
laser printer driver. Upgrade from Qdesign 1 £13. 
Runs withrom version higherthanJM, and Minerva. 


he graphics/art market is surprisingly 

small for a mature product like the 

Sinclair QL. In the early days, software 

like Eye-Q (Digital Precision) and 
Artlce (for those running the Ice pointer envi- 
ronment) dominated the market. However, nei- 
ther of these programs can now offer the power, 
sophistication and freedom of expression of 
CorelDraw/Dpaint/Harvard Graphics for the 
PC, or Dpaint for the Atari ST/Amiga. How- 
ever, the continued development of quality 
European graphics software - Painter (Progs of 
Belgium) and now Qdesign (Jochen Merz 
Software of Germany) will challenge estab- 
lished QL graphical software and bring the QL 
closer to the mainstream. Qdesign is advertised 
as a ‘Graphic and Design Program’, which 
suggests that Qdesign has aspirations in the 
DTP market. Unlike its graphics presence, the 
QL scene is abundant with powerful DTP pro- 
grams like DTP/DTP SE and ProPublisher 
(Digital Precison), PD2/PD2+ (Dilwyn Jones 
Computing) and now Qdesign from J Merz 
Software. 

Within 10 days of ordering, Qdesign arrived 
from J Merz Software (Germany). The package 
included a short but very informative A5 manual 
(34 pages) and a program disk (3.5 in). The 
software is not copy-protected, which has to be 
applauded, and backup was straightforward 
(TK2 weopy command worked fine). The boot 
program was run from disk, first, as if back in 
time to the good old days of the ZX Spectrum. 
The Qdesign loading screen quickly appeared 
with the obligatory Space Shuttle. The program 
finished loading and the eye-catching Qdesign 
main page appeared. 

The first thing you notice about Qdesign is 
the Qpac2 pointer environment (by Tony Tebby 
of Qjump), Imust admit to being a big fan of the 
Qpac2/Qimi mouse/pointer environment. The 
screen layout of Qdesign is spacious with smart 
icons and easy-to-use menus. 

At this point, I will diverge a little. The Qimi 
mouse board with clock (from Quanta or from 
J Merz Software), connects onto the main QL 
motherboard. The instructions are clear and 
installation straightforward. However, the first 
batch of Qimi boards gave some QL owners 
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problems - the board pin connectors are a bit on 
the short side, and with some QLs, the board 
has a tendency to spring out. Quanta, who 
make the board, were alerted to this fact and 
have fixed this for the second batch. Qimi is 
Gold Card compatible. Qimi works with any 
Atari compatible mouse (I picked up Truemouse 
for £14.99 at the Glasgow All Formats Fair last 
year). [highly recommend the Qimi mouse and 
in conjunction with Qpac2 (now discounted 
from Care Electronics) results in a powerful 
and friendly WIMP-type environment. 


Pointer extensions 


Qdesign includes some Qpac2 pointer envi- 
ronment extensions, and therefore does not 
require Qpac2 to work. Qdesign works equally 
well with both QL function/cursor keys and/or 
the mouse. The mouse makes art less restrict- 
ing and allows for greater artistic expression. 
The cursor is an arrow, and it is easy to locate 
on screen. To get started is simple: just start 
drawing on the sketchpad window, selecting 
icons from the Tools bar as needed - you have 
a choice of spray gun, text, paint can, shapes 
(square, circle and triangle - triangle includes 
other polygons, such as rectangle, pentagon, 
hexagon, etc.), different line patterns, magni- 
fication, and so on. All operations were instant. 
Clicking on the scrollbars at the bottom (left/ 
right) or right of the screen (up/down), scrolls 
the sketchpad window over another part of the 
page, however, the scroll bars could be a little 
wider in the y-direction. Selecting F5, or the 
Page icon, previews the entire page in low 
resolution (similar to Propublisher). F10 gives 
high resolution page preview. 

The top line of the menu bar includes a 
number of Qpac? icons, like putting Qdesign to 
Sleep, as a button (a button is a non-graphic 
icon) or Resize Qdesign or Move Qdesign. The 
bottom line of the menu bar, is the options 
menu Disk, Print, Font, Options, Block, Status, 
Blobs, Help and Quit. The last two options are 
self explanatory. The Disk menu is compre- 
hensive with an excellent intelligent file han- 
dler, Qdesign is able to identify the graphical 


AF Wilson became a Qdesign user last November, 
and sees it as a route to advanced graphics on the 
QL for more recent roms. 


file format to be loaded, and automatically 
loads PD2 or Propublisher or standard QL or 
Qdesign (compressed/uncompressed) or Atari 
ST (monochrome) screens into Qdesign. 
Qdesign can also save in any of the above 
graphical file formats. The ability to load/save 
Propublisher screens is important, particularly 
to Perfection (Digital Precision) users who are 
able to include Propublisher pages into 
wordprocessing documents. The Disk menu 
also includes the usual file utilities like Format, 
Directory, Device, Printer Driver and Configu- 
ration file. This menu also allows loading and 
saving of parts of screens (Cuts) and loading 
and saving of patterns. Patterns are useful for 
repetitive effects like carpet design. The Disk 
menu allows users to load standard QL fonts 
(or founts) and now Vector fonts (a first for the 
QL). Vector fonts supposedly give improved 
on-screen text, analogous to text printed on a 
laser printer compared with dot matrix printer. 
Certainly, the vector fonts provided with 
Qdesign are impressive. However, the pros and 
cons of one technology over another is outside 
the scope of this article. 


Compatibility 


The ability to load standard QL fonts allows 
compatibility with other graphics programs 
and font designers. Already three different 
screen font technologies exist within the QL 
graphics/DTP market - standard QL, High 
Definition and Vector. In the interest of com- 
patibility, hopefully software vendors like 
Digital Precision, J Merz Software, Progs and 
Dilwyn Jones Computing will modify existing 
software to cope with all three font technolo- 
gies. Unfortunately, Qdesign does not include 
a font editor. A number of standard font editors 
are available from other software vendors and 
from PD libraries and J Merz has just released 
Vec-Edit, a vector font designer. To view the 
fonts loaded, select the Font menu, all fonts are 
previewed and the user selects the desired font 
from the list. The ability to perform certain 
functions/operations on fonts is discussed later. 
Qdesigns compatibility with virtually all screen/ 
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DTP formats is welcomed. 

However, in conjunction with Print menu, 
the user has a extremely powerful graphics 
print dump, as powerful as Grafix (Digital 
Precision) but with better user interface. The 
printer options available include altering the X 
and Y resolution, print quality (number of print 
head passes) and Colour (shading on mono- 
chrome printers). Additionally, the user can 
specify Block, Screen, Window or Page. The 
printer output can be Portrait or Landscape 
(sideways). Mirror imaging is also supported. 
The print dump quality is superb, especially 
with 24-pin printers. Laser output is supported 
- J] Merz Software provides an upgrade version 
for an extra £7. 

A problem with Qdesign was the inability to 
escape a print dump once started - essential if 
the scaling was wrong. At this point it is worth 
noting a fundamental difference between 
Qdesign and Propublisher. Qdesign sketchpad 
is white ink on black paper, however, it prints 
out in reverse, ie black ink on white paper, 
whereas Propublisher provides black ink on 
white paper for both screen and printed 
hardcopy. There are two instances when this 
becomes important: 


(1) Printing a Propublisher screen from 
Qdesign to take advantage of the 
excellent printer driver. 


(2) Saving a Qdesign screen in Propublisher 
format for use within Perfection. 


In both cases, the DTP page will have to be 
Recoloured. This function can be performed in 
both Propublisher and Qdesign. Recolour 
Window is selected from Options and Recolour 
part of a screen (known as a cut) is selected 
from Block. Therefore to recolour a Qdesign 
page requires using Recolour from two menus. 
A more satisfactory method would be to have 
one Recolour selection with the ability to specify 
the page (unfortunately too many graphics/ 
DTP do not cater for page (global) operations), 
screen, window or block (cut). Qdesign does 
allow page colour inversion (why invert instead 
of recolour?), which should do the trick for 
normal monochrome print dumps. Other 
functions available from the Options menu are 
CLS page/window, mode 8 to4, reduce, outline, 
enhance and monoise and swap screen. 


Block menu 


The Block menu, as its name suggests, deals 
with cut and paste, essential tools in DTP. 
However, as above, page cut and paste is not 
catered for, although this could be easily im- 
plemented on Qdesign (select F10, and using 
Block menu to cut the appropriate section of the 
page, a magnified window at the bottom of the 
page just displaying the cursor line would make 
for a more accurate cut). Block operations are 
so straightforward that they require very little 
explanation Cut, Paste, Erase, Move, Recol, 
Mirror, Rotate and InOut. With Cut and Paste, 
and Move, the defined block is copied into a 
buffer and the block is displayed on screen as a 
boxed outline which can be relocated on the 
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page using the cursor keys or mouse. Rotate is 
a combination of 90-degree rotation with the 
ability to enlarge, however, no box outline is 
available to indicate the original dimension, 
which is a pain. Rotate needs to be updated, to 
conform to Cut and Paste, and to allow full 
rotation (0 to 360 degrees). A nice clock icon 
with degree markings would do the trick. 

The Status menu is packed with tool functions 
from brush types to italic slanting (left or right). 
The Status menu has four functional toggles: 
Under, Over, Fill and Good - and five new 
menus - IPWSZ, Blobs, Mode, Csize and 
VCsize menus. IPWSZ is short for Ink, Paper, 
Width, Side and Zoom menu. Good, which is 
short for ‘precision quality’, slows down the 
following operations: InOut, Mirror, Rotate 
and Print. As output quality is enhanced, in the 
same way as for printers, the print speed is 
sacrificed for NLQ text compared with Draft 
text. Mode specifies the colour resolution - 
two- or four-colour - and the graphic resolution. 
A word of warning: once the colour mode has 
been selected you cannot change it. Colour 
mode 4 is the best mode, but requires more 
memory. Clicking Qdesign or selecting F9 
displays the user number and the memory left. 
It would be nice to see a visual representation 
of the memory left, at all times. A fuel gauge 
type icon would be a useful indicator. 

The Blobs menu allows the user to select 
different brush types and previously saved 
patterns can be loaded into the menu. This is 
handy for wallpaper or carpet or any other 
designs thatrequire repetition. Csize and VCsize 
are font tools. Csize is as found in SuperBasic; 
refer to the QL user manual or QL World’s New 
User Guide. VCsize is new to SuperBasic us- 
ers, and offers users many font possibilities, 
similar to Propublisher toolboxes (Digital Pre- 
cision). Although the VCsize options are pow- 
erful, they are self explanatory: Mirror (X and 
Y), Shadow, Pixel, Bold (Left, Right, Up and 
Down displaced), IBM/QL font, Csize (X and 


Good 


Dense 5 


Ceize 6,6 
Width 4 
Sides 3 


Graphic 3: Bertor Font Ophons 


Mirror 4 Mirror ¥ IBM Shadow Pixel Right Doun Left up Right up 


Y), Italic (Left or Right slant, angle 0 to 180 
degrees), Outline, and Def-Grad. The last op- 
tion adjusts the angle of a text string on the 
screen (0 to 180 degrees). 


Qsnap 


Qdesign comes with an additional utility, 
Qsnap. Qsnap allows the user to capture either 
whole or parts of screens from any software. 
This is of use to game reviewers, or software 
authors writing documentation or any user 
needing a screen dump to file. Qsnap was used 
to obtain the graphics accompanying this arti- 
cle. Once the screen dump or snapshotis on file 
it can be loaded into any Graphics or DTP 
program for printing or whatever. Both Qpac1 
or Oram (Tony Tebby/Qjump) and Presgraph 
(AFW Software’s add-on utility for the com- 
munications program Terminal from TF Serv- 
ices) allow screen snapshots, however, Qsnap 
can also take snapshots of part screens. 

The manual is well written, short 
and concise. It includes information 
on 

Qdesigns file format for those interested 
boffins, and includes information on 
incompatibilities. First of all, Qdesign needs 
expanded ram and disk system and will work 
with the Atari ST QL emulator, however, the 
version I tried will not work on QLs with pre- 
JS roms or Minerva roms below 1.84. At a 
recent SQLUG meeting, Qdesign was tested on 
a number of machines with the following ob- 
servations: 


(1) JS + Trumpcard 2 + Qimi: perfect. 

(2) JS + Gold card: some of the menu names 
(Disk, Print, Block, Options) didn’t appear on 
screen at boot up. If you moved the cursor to 
where they should be and pressed space bar, the 
menu displayed without further inconvenience. 

(3) JM + Trumpcard or JM + Gold card or 
AH + Gold card: all didn’t load. 


Italic ® +: 98 


23 


SOFTWARE FILE 


In actual fact, I was surprised at the number 
of users still not using JS or 

Minervaroms. Overall, I was very impressed 
with Qdesign, Qdesign will do for graphics that 
Perfection did for wordprocessing. In addition, 
Qdesign can double as a printer dump utility 
and its graphic file compatibility is second to 
none. The Qpac2 pointer environment certainly 
enhances the product (remember Qdesign does 
not require Qpac?2 to run as all the necessary 
extensions are included) and a mouse (via Qimi 
interface) is essential for the serious user. How- 
ever, Qdesign lacks the text/wordprocessing 
file-handling capabilities of PD2 and & 
Propublisher and as such still requires some (> 
development if DTP is the ultimate goal. ; 
Qdesign will suffer from the JM/AH rom 
incompatibilities, however, QL users are an 
ingenious lot and a suitable patch is probably 
just around the corner. Hopefully, Qdesign will 
continue to develop, possible milestones being 
full DTP (V4), 3D-graphics (V5) and animation 
(V6). Lastly, the ideal companion for Qdesign 
or for that matter any graphics/DTP program is 
a hand-held scanner. Any ingenious person 
who can interface cheap IBM PC hand-held 
scanners via the QL serial interface is onto a 
winner. 

For further information: 


NS te 


— 
7 


SQLUG: 031 660 1826 (Alan Pemberton - to 
join) 

Care Electronics (authorised Tony Tebby/ 
Qjump suppliers): 0923 894064 


SR ffl 
Fl Help quit 


raphic l: Space Shutile 
. — gear? 
a, a= gat 


(Space shuttle reduced - see OPTIONS) 
(Reduction - height and length by 20%) 


A Quantum Leap in QL Wordprocessing 


Our new state-of-the-art wordprocessor, text87plus4 is now available in version 3. MILES ahead of any QL application! 


text?” plus4 


+ | USER FRIENDLY TO THE EXTREME 


e New well-written manual e Automatic setup and 
installation e Context-sensitive help e File selector boxes e 
Commands and key-presses highly compatible with Quill. 


+2 THE MOST POWERFUL QL WP 


e Extensive navigation and editing ¢ Fast block and search 
/ replace operations e Reformats as you edit e 
Remembers paragraph formats between sessions e 
Extensive file commands e Spell Checker with browse and 
replace e Multi-Window Multi-Document « Page-Preview 
and Pagination save a lot of time and effort. 


+3 UNRIVALLED PRINT QUALITY 


e Nothing else can compete In text and character 
formatting e Fully supports proportional spacing and 
justifles correctly e Multiple paragraph formats with 
different margins and line-spacing e Right, centre and 
decimal tabs e Multiple columns plus headers and footers 


e Desktop publishing with several different page layouts in 
the same document . 


+4 FASTEST QL WORDPROCESSOR 


Amazing timings on an ordinary QL (much faster with Gold 
Card) and Atari ST with QL emulator. A 70 page text 
(24,000 words, 141,000 characters) was used e Load: 25s 
(STQL 17s) ¢ Save: 37s (STQL 32s) e Search / replace (with 
auto-reformat) 580 instances: 43s (STQL 14s) « Change 
justification: less than 2s (STQL 1s) e Change right margin 
and reformat 65s (STQL 17s) e Move 10 pages from top to 
bottom (With manual marking and positioning): 35s (STQL 
15s) e Scroll screen 100 lines: 19s (STQL 5s) 


Fully compatible with all QL ROMs, Gold Card, ST QL, 
Thor. Requires disk drive and 256K memory. 


Prices (inclusive of Air Mail to overseas) 
text87plus4 £ 79.00 
2488 drivers for 24pin and Bubblejet printers € 19.00 
typeset90-deskjet drivers for all HP Deskjets £ 19.00 
typeset90-Epson GQ5000, EPL4100 /7100 lasers £ 39.00 
fountext88 + founted89 £ 39.00 
Graphic driver for 9 & 24-pin printers with over 30 founts 


Ask for our free, comprehensive leaflets. 


SPECIAL OF FER! extended until end of September If you have paid over £59 for any other QL wordprocessor 
you can upgrade to text87plus4 for only £59. The manual from the other software is required as proof of purchase (It will 
be punched and returned) .Send cheque, Eurocheque, to: Software87, 33 Savernake Road, London NW3 2JU 
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SECTION 


EIGHTEEN 


NEW 
USER GUIDE 


KEYWORD INDEX 


This month in the Keyword Index, Mike Lloyd 

@ starts with EXIT, and concludes with FOR 
indent. This section should follow section Fif- 
teen (June 1992 issue). 


EXIT control 


STRUCTURE COMMAND 
control a numeric variable controlling a structure 


FOR...NEXT loops have a built-in escape route because the syntax insists on a finite number of repetitions before the rest of 
the program is carried out, but it is always nice to be able to leave a loop prematurely. REPeat loops left to their own devices 
will last forever and so an explicit exit condition is essential. In both circumstances the EXIT keyword, followed by the variable 
controlling the loop (called the identifier by Sinclair), will cause the interpreter to skip immediately to the line following the 
appropriate END structure command. See the entry for FOR...NEXT for an explanation of the distinction between END FOR 
and NEXT in this context. 


The nice thing about EXIT followed by the loop control variable is that it allows you to escape with one bound all of the layers 
of a multi-nested loop. Programming purists might object to this approach, but the SuperBasic interpreter does not. 


£ EXP(n) 


MATHEMATICS FUNCTION 
n anumber between -500 and 500 


EXP, short for exponent, is followed by a value which is taken to be the exponent of the transcendental number e, or 2.718282... 
One of the many interesting properties of e is that when it is raised to the power of pi multiplied by the square root of -1, the 
resultis -1. Sadly, this is of little use to QL programmers, as the square root of -1 is an unreal number outside the range used 
by the SQR() function. The value of e is the basis for natural logarithms. 


EXTERNAL module%, “group”, 
specification 
[Turbo Toolkit] 


COMPILER DIRECTIVE 
module% an integer constant 
“group” a string constant 


specification (optional comma-separated repetition) a variable or an array, or a function or procedure call, or the word 
FUNCTION or PROCEDURE. 


The Turbo compiler permits programmers to link together program snippets, so combining frequently-used utility routines into 
® many different programs. This faciilty is not available in interpreted SuperBasic and sois only briefly dealt with here. EXTERNAL 
and GLOBAL establish links between the program calling a routine and the program containing the routine respectively. Where 
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EXTRAS #chan 
[Super Toolkit !I] 


FDAT(#chan) 
[Super Toolkit II] 


the specification refers to a procedure or a function the name of the structure is preceded by the keyword PROCEDURE or 
FUNCTION (spelt outin tin full and followed by a comma),. Arrays are declared with dummy dimensions, suchas STRINGS$(0,0). 
GLOBAL directives can be split across several lines, each identified by a string constant. Ifan EXTERNAL call refers to a string 
constant, it only needs to include the items listed on the given GLOBAL statement. 


MEMORY COMMAND 
#chan (Optional) A valid output channel. 


EXTRAS is a valuable means of finding out what extensions to the SuperBasic language have been added. The list includes, 
in the order in which they were declared, all additional keywords provided by Super Toolkit !I and any other software. There 
may be a few surprises, such as those which remain when Professional Publisher is exited, and even keywords which you had 
forgotten about. People are usually astonished simply by how many there are. 


PRINT UTILITY FUNCTION 

amount an amount to be converted to a string 
width the number of characters in the string 
decimals the number of decimal places to include 


The FDEC$ function replaces yards of code by converting a number to a string of fixed length with a given number of decimal 
places. Immediately, all the problems of scientific notation are avoided and the difficulties of lining up columns of numbers are 
resolved. Anyone who has struggled with a way round printing two pence as 0.02 will be delighted! 


FEXP$ (amount, width, decimals) 


[Super Toolkit II] 


FILL #chan, toggle 


FILL$(char$, width) 


FLASH #chan, toggle 


FLEN(#chan) 
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PRINT UTILITY FUNCTION 

amount an amount to be converted to a string 
width the number of characters in the string 
decimals the number of decimal places to include 


This function prints a fixed-length string giving a value in exponential form (eg “ 1.786E=02" or “ 3.21E.02”). The string should 
have at least seven more characters than the specified number of decimal places. 


SCREEN GRAPHICS COMMAND 
#chan (Optional) a screen channel 
toggle 1 or 0 representing on and off 


The FILL command ensures that any sequence of lines which bounds an area will cause that area to be filled with the current 
ink colour. The algorithm used is much less sophisticated than that , say, of Digital Precision’s Eye-Q drawing and so itis abit 
wobbly on re-entrant shapes. A bug can also leave odd lines unfilled in circles. With FILL on and OVER set to -1, a succession 
of circles causes the leaking ink to form a psychedelic experience all over the screen. To avoid this phenomenon place a FILL 
1 command between each shape you draw, or buy the Minerva rom: it corrects the bug and makes life dull again. 


STRING FUNCTION 
char$ a string with one or two characters 
width the number of characters returned 


FILL$ tackles the problem of declaring long strings of identical characters, such as 80 spaces or even 132 underlines. The first 
argument is a one- or two-character string which is repeated to form a string with as many characters as that for repetitions of 
less than around a dozen characters it is more efficient to type them out longhand than use the FILLS$ function. FILL$ is unusual 
because it both takes and returns a string. 


TEXT DISPLAY COMMAND 
#chan (optional) a screen channel 
toggle 1 or 0 representing on and off 


FLASH only works in the QL’s low resolution eight-colour mode and only applies to text. After issuing a FLASH 1 command 
all text is displayed in a flashing state. Unlike the earlier Spectrum, the QL’s flash does not reverse foreground and background 
colours, but prints the text in alternating foreground and background colours. FLASH 0 provides a steady state for subsequent 
text. Ifa graphic overwrites flashing text the results are almost always unattractive and subsequent graphic drawing becomes 
unpredictable. Even Minerva does not solve this problem. 
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[Super Toolkit II] 


FLOATS$(number) 
[Turbo Toolkit] 


FLUSH #chan 
[SuperToolkit Il] 


FNAMES(#chan) 
[Super Toolkit II] 
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FILE FUNCTION 
#chan A valid file channel 


FLEN belongs to the Super Toolkit family of functions which interrogate the Qdos file header for useful information, in this case 
the length of the file attached to the given channel. 


NUMERIC CONVERSION FUNCTION 
number Any valid number within the QL’s range for floating point numbers. 


The QL does not store floating point numbers as “123.456” because it wastes space and slows down mathematical operations. 
Instead it uses a format in which every floating point number is represented in 6 bytes. This is patently wasteful for simple 
integers, but more efficient for numbers with many significant digits. Sadly, the QL’s nonsensical storage and manipulation of 
integers does not improve ona function which returns the internal storage format of a number as a strong. The string can then 
be sent to a data file, for example. 


FILE COMMAND 
#chan a file channel 


The FLUSH command coaxes information out of temporary Qdos buffers and onto the file storage medium. This operation 
normally happens automatically when a file is closed, but you may want to flush the buffers to avoid catastrophe should a power 
cut strike while a file is open. 


FILE FUNCTION 
#chan a file channel 


Should you forget the name of a file to which a channel is attached, or should you wish to display its name for your user's benefit, 
this function reads the required information from the file header. 


FOPEN(#chan, name) 
FOP_IN(#chan, name) 
FOR_NEW(#chan, name) 
FOR_OVER(#chan, name) 
[All Super Toolkit Il] 


FILE FUNCTIONS 
#chan (optional) a channel linked to a file 
name a valid filename 


SuperBasic is at its most unreliable when files are being opened. Should the file not be there, or the medium full, or the device 
name invalid there is only one outcome: an error message. If you are developing software for other people, or even if you want 
intelligent software for your own use, this zeal for bringing proceedings to a premature halt is unacceptable. Super Toolkit's 
FOP_ family of functions provides a way of intercepting all errors related to opening files. In addition, the functions can select 
unused channels automatically. 


For example, FOPEN(#3,flp_junk) attempts to link channel number three to an existing file flo1_junk for both reading and writing, 
If the operation fails for any reason, the function will return a negative number representing an error code (see the entry for 
ERNUM for details). A successful operation returns the value 0. If the channel number is omitted, the function will return either 
an error code or a positive integer representing the channel number allocated to the file, as in: 


150 handle = FOP_NEW(flp1_filename) 


The rest of the FOP_ family works in the same way, but FOP_IN provides read-only access, FOR_NEW creates a new file 
(assuming that the filename is presently unused), and FOP_OVER overwrites any existing file of the same name. 


FOR ident = range1 STEP increment, range 2 STEP increment 
FOR ident = num1, num2 


EXIT ident 
NEXT ident 
END FOR ident 
LOOP STRUCTURE 
ident A floating-point numeric variable 
range1, range2 Oneormore ranges ofthe form5TO 20 separated by commas 
num1, num2 One or more numeric values separated by commas 
increment (Optional) A numeric variable. If increment is not used, the STEP keyword is omitted 
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and an increment of one is assumed. 


In SuperBasic the FOR...NEXT loop updoubtedly reached the heights of sophistication. Given that 
all computer programs are ultimately stretches of commands structured with loops and branches, 
the importance of the FOR...NEXT loop is difficult to overstate. The structure begins with a 
declaration which determines the name of the controlling variable, the range or ranges of values 
it will adopt, and the value by which it will be increased or decreased with each cycle of the loop. 
The end of the loop is indicated by an END FOR statement. Any commands between these two 
lines will be carried out each time the loop is cycled. A trivial example will clarify the above if it is 
at all unclear: 


100 FORx=17T012 
110 PRINT x 
120 END FOR x 


To increase its usefulness, the STEP keyword can be added to alter the default increment of one. 
To count down from twelve to one in the above example, change line 100 to read FOR x = 12 to 
1 STEP -1. The STEP value need be neither whole nor positive. A single FOR loop can have a 
number of ranges, each with its own STEP value if required. 
Ranges and STEP values can be represented by variables, as in the statement 

FOR a=bTOcSTEP d. The interpreter relies on the programmer to ensure that the values held 
by the variables make sense. A loop from 34 TO 12 STEP 1 will never end. Clever programmers 
are often tempted to change the values of variables in the FOR statement during the loop itself, but 
this is usually a dangerous game. Changes to a STEP variable within a loop are ignored. 

To print out the numerals, capital letters and lower-case letters from the Ascii 
set, the following FOR...NEXT loop will suffice: 


FOR char = 49 TO 57, 65 TO 90, 97 TO 122: PRINT CHR$(char) 


The example also shows another of SuperBasic’s improvements on the ordinary FOR...NEXT 
loops found in inferior Basics. If the FOR command is followed on the same line by the statement 
or statements which form the main body of the loop, the END FOR statement can be dispensed 
with. 

SuperBasic also makes it easy to specify an irregular group of values in a 
FOR...NEXT loop. Simply replace ranges with single values, such as: 


FOR x = 3, 6, 2, 9, 11, 4: PRINT x 


There may also be the need to leave a loop prematurely, perhaps because some condition has 
been met. A typical scenario might be “search this array until either an element equal to ‘QL 
WORLD? is found or until the end of the array is reached”. Assuming that the number of array 
elements is represented by the variable max, a loop can be set up to cycle through the values from 
1 to max. Not only is the FOR...NEXT structure able to cope with the algorithm, but it encourages 
an extension along the lines of: “if a matching element is not found print a warning message.” 
The functionality to interpret the second part of the algorithm lies in the keyword 
EXIT and its interaction with the keywords NEXT and END FOR. Here is a suitable program snippet: 


100 REMark : Assume array of MAX elements exists 
110 FOR x = 1 TO max 


120 IF array$(x) = “QL WORLD”: EXIT x 
130 NEXT x 

140 PRINT “The search was unsuccessful” 
150 END FOR 


160 REMark : The program continues ... 


The NEXT line causes the interpreter to return to the start of the FOR...NEXT loop. If the loop 
continues uninterrupted to its maximum value the interpreter will drop out at line 130 and print the 
error message. Such lines between NEXT and END FOR are called the “loop epilogue”. The END 
FOR is simply ignored. If, however, a match is found, the EXIT command will be executed and the 
interpreter will go to the line immediately following the END FOR, by-passing the loop epilogue. 
While this can be very neat, it does not suit all circumstances: what to you do when you want to 
take one action if the loop continues to the end, and another action if the loop is left prematurely? 
Traditional Basic programmers are conditioned to ending FOR loops with 
NEXT, but this does not help the SuperBasic interpreter because it thinks that the rest of the 
program could well be a loop epilogue. Only when an END FOR is encountered will it forget about 
the existence of the loop. The short advice is always end FOR...NEXT loops with END FOR. 
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HARDWARE 


Care Electronics 

0923 672102 

Peripherals and accessories. 
Thor International 

010 4533 930305 

010 4533 937544 

Digital Precision 

081-527 5493 

Discs, interfaces, drives, keyboards, 
RAM expansions. 

EEC Ltd 

0753 888866 

QLs, peripherals, accessories 
Miracle Systems 

0904 423986 

Trump Card interface, modems, 
hard disc drive. 

Strong Computer Systems 
0267 231246. 

S.P.E.M 

Via Aosta 16, 10154 Torino, Italy. 
+39 11 857924 Fax +39 11280009 
QL disk interfaces, ram, eprom 
holders. 

TF Services 

071 724 9053 

Repairs, spares, peripherals. 

TK Computerware 

0303 812801 

Peripherals. 


y Lede Feeley 
SERVICES 


Adman Services 

0952 255895 

Joe Atkinson 

36 Ranelagh Road, London W5 5RJ 
Roms, mdvs and all spares. 
Suredata 

081-902 5218 

Repairs. 


QL World 

(reader services) 
Subscriptions and back issues 
0869 83677 

Quanta 

User Group, support. 

Hon. secretary, Phil Borman. 
0933 460690 
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SOFTWARE 


Athene Consultants 

0705 511439 

ARK Distribution 

0983 79496 

Archivist, Master Spy and other business 
and utility software. 

Call Us What You Like 

55 Greenan, Shaws Road, Belfast BT11 
8LX. No telephone. Superspy. 

Care Electronics 

0923 672102 

Tony Tebby software. Miracle hardware, 
peripherals, utilities. 

CGH Services 

0559384 574 

Adventures. QLAF, DIY Toolkit. 
Compware 

0270 582301 

Task Swopper, Mega Toolbox, Expert, 
System Shell, Speedscreen and others. 
COWO Electronic 

010 41 45 211478 (Switzerland) 

QTop, Atari QL emulator, Thor support 
Digital Precision 

081-527 5493 

Turbo Basic compiler, Desktop 
Publisher, Editor, Eye-Q Graphics. Sprite 
generator, Super Forth, Better Basic, 
Professional and Super Astrologer, 
Media Manager, Supercharge, 
Blocklands, Droidzone, Aracadia, 
Reversi, Backgammon, Master Bridge 
Tutor, C-M Emulator, C compiler, 
Lightning speed enhancer, Perfection. 
DJW Software 

0256 881701 

Homebanker 


Dilwyn Jones Computing 

0248 354023 

Home Budget, Vision Mixer, QL 
Genealogist, Textidy, Spellbound and 
others. 

ImaQLate Software 

42 Albion Street, Broadstairs, Kent CT10 
INE. 

Biograph. 

Jochen Merz Software 

010 49 203501274 

QL/Atari Emulators, utility and games 
software. 

Lear Data Systems 

6 Southview Green, Bentley 

Ipswich, Suffolk IP9 2DR 

Qtris 

Liberation Software 

081 546 7795 

Basic compiler (QLib) and utilities. 
Progs (Van Auwera) 

010 32 16 48 8952 (Belgium) 

The Painter, The Clipart, Data-Design, 
Qractal. 

QFILE 

Apartado 2110 p-1103 Lisboa Codex, 
MS-Link and Discopy. Portugal. 

QL Supersoft 

0256 475992 

Spell, Numbers, Superdraw. 
Qubbesoft PD 

38 Brunwin Road, Rayne, Braintree, 
Essex CM7 5BU 

Public domain software. 

SD Microsystems 

0462 422897 

Business software including General 
Ledger. Small Traders’ Pack/Invoicer 
and Stock Accounting. 

Software 87 

33 Savernake Road, London NW3 2JU 
Text 87 and updates. 

Talent Software 

0303 813883 

Utilities, games. 

TK Computerware 

0303 812801 

Add-ons, spares, software. 

WD Software 

0534 81392 
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PERFECTION 


SPELLCHECKER 


Perfection puts a spell on Bryan Davies, without even sexisming him. 


INFORMATION 

Program: Perfection Spellchecker 
Price: £49.95 for basic program plus 
three dictionaries, 

£29.95 extra for Huge (Mega) diction 
ary, otherwise enquire supplier. 

SAE plus disk for small dictionary (ex 
isting owners of Spellchecker only). 
Supplier: Digital Precision Ltd. 

222 The Avenue 

Chingford 

London E4 9SE. 

Tel. 081 527 5493 


his program is separate from 
the PerfectionWP program and 
can be used either in conjunc 
tion with it, or on its own. That 
is, itis not dedicated to Perfection but can 
be used with text files from other editors 
and WP programs. It is a more ambitious 
project than previous QL spelling checker 
programs, both in the size of its dictionaries 
and in the facilities it does, or will, offer. 
Before going any further, please note 
that “dictionary” used generally in this 
context means alist of words against which 
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spellings can be checked, nota list of word- 
meanings in. This usage leaves the way 
clear for “word list” to refer to a file contain- 
ing words not found in a dictionary during 
document-checking, and stored as a 
separate, text file, for later conversion into 
a user dictionary. 

One of the prime aims during de- 
velopment was to create really big dic- 
tionaries, far beyond that provided by 
SpellBound, Qtyp or Qspell). Not only that: 
itwas thought worthwhile giving “one in the 
eye” to PC software by making the biggest 
dictionary well above the size of anything 
normally found on PCs. At about 360,000 
words, the “Mega” Spellchecker dictionary 
does not have much competition, on any 
computer! 


Sheer size 


Sheer size always creates problems 
on the QL, which is not the largest of 
computers in several respects. Memory 
size and processing speed are at a pre- 
mium, so Digital Precision have opted to 
supply several sizes of dictionary, to suit 
the available ram on users’ QLs. The larg- 
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est dictionary (called either Mega or Huge) 
can be used only when the QL system has 
1.5 MB of ram, which effectively means a 
Gold Card must be fitted, and a HD or ED 
disk drive. This dictionary file is too big to fit 
into the Trump Card ram, and too big to fit 
onto a DD (720 KB) disk. It might be ac- 
ceptably fast with the basic QL, but the 
extra urge of the 16 MHz GC processor 
doesn’t come amiss. 

The standard big dictionary holds 
about 220,000 words (the numbers change 
as development continues, so don’t take 
them as gospel) and can be used on a 
system with 768 KB Trump Card and DD 
disk drive. The medium dictionary has 
150,000 words; it, also, requires the 768 
KB Trump Card. The small dictionary has 
amere 77,000 words and can be used with 
256 KB Trump Card (or comparable 
memory expansion) and 360 KB disk drive. 
Various in-between sizes can be provided, 
depending upon development and available 
space on the supplied disks. A word of 
caution: the memory sizes are nominal, 
and you may find that you need the next 
size up for practical use, as you may not 
find it convenientto have only Spellchecker 
loaded when checking documents. For 
example, you may want Perfection loaded, 
which needs around 140-160 KB for itself, 
plus the necessary document space 
(roughly the same space as the file takes 
up on disk). 


On disk 


Spellchecker works on the QL, 
Thors, and the QL emulator on the Atari 
ST. Most of the dictionaries are too large to 
be supplied on cartridge; all combinations 
but the largest are usually supplied on 3.5- 
inch DD (720 KB) disk, and this one is 
supplied on HD (1.44 MB) disk. DP has 
thought about Gold Card owners who do 
not have a HD or ED drive but wish to use 
the largest dictionary, and the latter can be 
supplied “in pieces” on DD, together witha 
routine to stitch it back together into ram. 

The method of checking spelling is 
unusual; leastways, users familiar with 
other programs may find the DP approach 
different. The conventional way is to have 
the text file (document) loaded in a WP 
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program, andtocallup the spelling checker, 
which then takes over from the WP pro- 
gram until checking is completed. As “un- 
known” (to the dictionary) words are en- 
countered, the user is asked to make a 
decision about them - typically add them to 
a supplementary word list, ignore them, or 
ask for alternative suggestions. 

Perfection Spellchecker is called up 
as a separate program. It takes control 
from Perfection if that is in use, but it can 
also be used when no WP (or editor) pro- 
gram is running. From here, though, it 
diverges. It has three modes of operation - 
as a concurrent checker of text you are 
typing into the current Perfection docu- 
ment (but not into any other program); 
Page or Block mode checking of the cur- 
rent Perfection document; and retrospec- 
tive checking of existing document files 
(not necessarily Perfection ones). 


Concurrent 


The concurrent mode is quite like 
that of SpellBound when it first came out, 
which attracted some criticism because it 
was the only mode available. The retro- 
spective mode is akin to the more useful 
combination of SpellBound 1 and 
FileBound, or SpellBound 2. The Page/ 
Block mode is what is usually used on 
other computers. 

The divergence | mentioned may not 
be clear from the description so far. It 
arises because, whatever the checking 
mode, unknown words are notincorporated 
into existing dictionaries or wordlists dur- 
ing the initial checking process. The un- 
knowns are marked, visibly, and the user 
has the option to go through the document 
manually making corrections, or to submit 
it to processing by the separate Dictionary 
Utility (DU) program. 

The first illustration is of the Perfec- 
tion screen, with the MENU2> block of 
options displayed at the top, to show the 
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spell-checking options; the current docu- 
ment has been checked, but the highlight- 
ing of the marked unknown words “ARLL” 
and “RLL” (twice) is not obvious because of 
the limitations of the screen dump process. 

The secondillustration is ofthe menu 
options when the Dictionary Utility is started. 
This latter program has several options; 
remove the marks from a spell-checked 
document and add the marked words to a 
user word list, sort a user word list alpha- 
betically and remove duplicates, sort a 
word list and remove duplicates then cre- 
ate a user dictionary from it, configure the 
program itself, and configure Spellchecker. 
It takes quite a lot of memory (something 
over 200 KB by default), because itreserves 
workspace to handle files to be checked, 
but the reserved space can be user-set 
when the program is configured. 


High speed 


With more than one operation needed 
to complete a spell-checking session, the 
speed of the individual operations needs to 
be high to give overall efficiency. There is 
not much that can be done to speed up the 
physical side of using the various pro- 
grams - the keying in of device and file 
name, selection of options etc. Assuming 
the user will normally be running Perfection 
and checking documents after production 
in it (comment on concurrent checking 
comes later), the procedure is to EXEC 
Spellchecker, either prior to or after start- 
ing Perfection, use the F3 F3 P (Pages) or 
F3 F3 B (Block) command to run the mark- 
ing routine (an interchange of information 
between Spellchecker and Perfection), then 
run through the marked document using 
the Search command to find instances of 
Strip 2 (the code used to mark the start of 
unknown words). 

The markingis done very fast- 40,000 
or more words per minute ona Trump Card 
QL, several times that with a Gold Card 
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fitted. This is about four times as fast as 
the best figures | have seen with other 
checkers on QL and PC. Strip 2 areas are 
shown by red highlighting (default 
colouration) and you have to remove any 
of these which mark words you do not 
want added to your word list. You can 
make these choices when using the DU 
routine itself, but the error words are then 
displayed on their own - not in context - 
and it will not always be obvious whether 
or not they actually are errors. 

One way to remove the Strip 2 code 
is to find it via a Search, move the cursor 
one character to the right, then use 
CTRL+D. CTRL+G restarts the search 
each time. The aim is to leave only words 
which are to be added to your word list 
marked. This can be a lengthy process if 
there are many marked words which have 
to be unmarked. Repeated appearances 
of the same unwanted word do notall have 
to be unmarked, although Spellchecker 
marks all occurrences of unknown words, 
however many times they occur; DU al- 
lows you to deal with the first instance of a 
repeated word then ignore subsequent 
ones. 


EXEC utility 


Once the manual checking process 
has been completed, the file is saved and 
DU is EXECed. DU gets its job done quite 
quickly. It can be killed once it is no longer 
needed, but removing it doesn’t appear to 
increase contiguous memory space. 

The initial marking of errors ina file is 
so fast that it might seem impossible to 
make it significantly faster, on any machine. 
Simply marking errors doesn’t get the job 
done, however, and there has to be another, 
“proofing” stage. You can edit the marked 
file yourself, and this is all you need do if 
you have no great problem with your 
spelling, and no desire to add unknown 
words to a word list. That is, if you make 
typing errors, butcan normally correctthem 
as soonas they are spotted, there is no real 
need to continue to the next stage (using 
the Dictionary Utility). 

Having to switch to an external rou- 
tine and then manually accept or reject the 
errors naturally adds considerably to the 
overall time taken. During the review period, 
there was a fair amount of discussion on 
speed of WP programs in general, and 
tests were done on a large (40,000-word) 
file to see if the overall time taken for a 
complete spell-checking, -correction and 
word-list updating operation was materi- 
ally different in one WP program when 
compared to another. The Perfection 
Spellchecker was definitely the faster of 
the programs being compared. If the file 
was just marked and then checked manu- 
ally, the speed difference could be con- 
siderable; putting the checked file 
through the DU routine reduced the per- 
formance advantage to maybe 15-30%, 
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which is still a clear mar- 
gin. Not making your own 
word list, to hold any words 
not in the dictionary used, 
speeds up checking con- 
siderably, but being able y 
to create your own diction- may type fast, 

aries is obviously an at- rnd y sore than tt 
traction for many users. 
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Whichever way you go 
about getting a computer 
program to check your text, 
you can’t escape having to 
make decisions yourself. The i 
program says something is Onee the current document hes 
wrong, but it is up to you to be run through the Dictionary Lt 
say what it is. Spellchecker the unknown words con be added to @ word-List- 
offers no alternative spellings 
for words it doesn’t recog- 
nise in the text; if you aren’t 
sure what spellings are, you 
have to get out a paper dic- 4 Neco eee ce ae gC 
tionary and check. The com- 
petitive QL spelling checkers do offer acters and some of the types of error that 


SS Tee Tn TTA I MOM MMU 


alternative spellings, but the function is . are picked up (or not, in one case). 

very basic. The first few characters of the User choice Despite DP’s reservations, concur- 
error word are taken as the basis and a rent checking is eminently usable. It has 
selection of other words having the same The concurrent checking mode is the distinct advantage that the spell- 


Starting string is displayed. If the error not something which DP makes a lot of. checking job is over and done with straight 
was of a type where, for instance, the first The instructions indicate that this mode away. If you type relatively slowly, don’t 
letter was typed incorrectly - e.g typing was putin purely because some users will make mistakes every few words, and make 
“xar” instead of “car” - any alternatives have got used to having it, as owners of typographical errors rather than being bad 
offered are unlikely to help. DP argue SpellBound. DP doesn’t recommend it, ON at spelling, this mode should be quite sat- 
that, unless alternatives can be offered the basis that it is obstructive. It certainly isfactory for you. 
on phonetic and interpretive bases as does slow down the flow of typing, but QL 
well as a simple character-comparison users in general are not going to be “ma- = 
one, there is no point in providing the chine-gun” typists and may not really be Games coming 
facility; as the QL really hasn’t (yet) got unduly disturbed at being stopped every 
the power to handle such comprehensive time they type a word incorrectly. At the start of this article, it was implied 
checking, and the cost of incorporat- The awful behaviour of the original that the current Spellchecker is not the end of 
ing it could not be recouped in the SpellBound (fixed in SpellBound 2), where the line. A good, big dictionary can be used as 
small QL spellchecker market, it is ittrippedoutatthe slightest provocation, is the base fora variety of word games. Forthose 
best left out. a thing of the past.The Perfection interestedinwordgames, this willbe one ofthe 
Not all users will agree, as certain Spellchecker behaves well, remaining ac- main attractions of the program. The intention 
types of error are such that comparison-_ tive even if you move the cursor back to is to offer a variety of additional functions, 
based alternative spellings actually do previously-typed text and make changes. making use of the remarkable size of the 
provide the required answers. Some It beeps on errors only at the point a word dictionary and the high speed of checking. 
Standard transposition errors, such as_ de-limiter is typed, which is usually when Development has been going on for some 
typing “thta” instead of “that”, willproduce you type a Space after the current word. months, and we should soon see some of the 
alist of alternatives containing the correct SpellBound beeped immediately a string fruits of this. 
spelling, in Qtyp or SpellBound. But you of characters didn’t make sense to it, re- Those whose memories stretch back 
will have to resort to using the paper gardless of whether or not the end of the to the QSpell checker sold by Eidersoft in 
dictionary at times, whichever QLchecker wordhadbeenreached. Havingbeengiven the middle 80s will recall that it had some 
you use. the beep, you retrace your steps, make the good functions, such as finding all words 
Checking files outside of Perfection correction required, then carry on. You containing a given string of characters, but 
is quite straightforward and requires only don’t have to make corrections there and was spoilt by slowness and some truly 
Spellchecker itself to be EXECed andthe _ then, as Spellchecker inserts one of DP’s memorable dictionary corruption problems 
Alt+Capslock key combination pressed. collection of unusual characters - a capital (my copy invented thousands of “words” 
It doesn’t appear to matter what the text X above a small x - after each unknown such as “shortcircuiteding” and “sexisming” 
file type is. Spellchecker goes through word and you can edit them later. A small and added them to the dictionary). 
and puts a top-hat character (‘) against point, but the marker replaces the Space The Perfection Spellchecker will, in 
every word not found in the dictionary. (or other de-limiter) between the unknown future, provide functions for the crossword 
Provided the originating WP or editor wordandthe next one, andyouhavetore- puzzler, the anagram enthusiast, and 
program can search for that character, it type the space after deleting the marker. anyone else with an interest in words for 
is then easy to find all the unknowns and An illustration is give here of the their own sake. Maybe we will even see 
deal with them. Word lists can be created Perfection screen during a session of typ- some form of contextual and/or grammar 
in the same as way as with Perfection ing with Spellchecker active in the concur- checking. The program will then provide 
files. rent mode, to show both the marker char- both utilitarian and recreational benefits. 
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device. 


Simon Goodwin exercises the QL vocabulary and 
shows how to send neat columns to any Qdos 


his new DIY Toolkit project 

generates neat form atted re 

ports on the vocabulary of your 

SuperBasic interpreter. It suits 

all QL systems from AH to 

Minerva, and requires only 276 
bytes of memory. This means that there’s 
not much hex data to enter, from Listing 
two, to get the versatile VOCAB command 
on your QL or emulator. 

The VOCAB extension was sug- 
gested by reader David Moseley of Cov- 
entry, prompted by the deficiencies of 
Toolkit 2’s EXTRAS command. “EXTRAS 
is irritating even for Toolkit 2 on its own”, 
writes David. “With additional keywords 
being added, and especially with the po- 
tential explosion which SET can bring, itis 
quite exasperating watching them scroll up 
the screen twenty, or so, at a time.” 

| have found the same problem when 
testing new keywords and programs, un- 
certain of the names known to my system. 
Even if | set_ SCROLL 10 and CSIZE 1,0, 
to boost the text output speed, the EXTRAS 
list leaves much to be desired. 


Column widths 


VOCAB, short for VOCABULARY, 
has many advantages over EXTRAS. It 
uses a columnar display, adjusting to the 
width of the output window or device. If a 
name is too long to fit the column width it is 
truncated to ensure at least one space 
between adjacent columns. 

You can configure the column width 
and default channel to suit your own sys- 
tem, or change the command name with a 
few POKEs, as | shall explain later. 

VOCAB shows resident procedures 
and resident functions separately, so 
commands and SET functions, among 
others, appear in distinct reports; VOCAB 
9 shows the functions. 

These are only two of the ten types of 
Name Table entry; VOCAB can also report 
on SuperBasic procedure and function 
names, arrays, loop identifiers, scalar 
variables and unset names. The only type 
beyond its remit is type 1, expression en- 
tries which have no corresponding name. 

VOCAB takes two optional param- 
eters: a channel number, and a Name 
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Type. Possible Name Types are listed in 
the Table, and discussed in most books on 
SuperBasic and Qdos. VOCAB 0 shows 
names that would give the value * if 
PRINTed; these include device names like 
SER1 and flp1_BOOT, unless they appear 
in quotes in your program. 


Variables 


VOCAB 2 shows simple variables, 
including undimensioned strings, while 
VOCAB 3 reports the names of DiMed 
variables, and so on. If you need to docu- 
ment an existing SuperBasic program you 
can make a good start by loading it and 
using VOCAB to report the names it uses, 
in each SuperBasic category. 

VOCAB reveals all the names known 
to the current SuperBasic task, so itis most 
useful from interpreted Basic and fairly 
pointless in compiled code. If you use it in 
a MultiBasic task it shows the ‘local’ resi- 
dent names, which may differ from other 
Basic tasks. 

The command needs to know the 
number of characters that can fit on each 
line, in order to work out the number of 
columns available. This is easy enough 
when the output channel is a window, as 
the standard Qdos call SD.CHENQ returns 
the width in characters, taking account of 
the MODE and CSIZE. 

Disappointingly, SD.CHENQ only 
works if the channel is a window. It is no 
use for serial output channels such as files, 
SER and PAR. The QL operating system 
Qdos keeps no record of the ‘width’ of 
these channels. However the SuperBasic 
system keeps extra variables in its own 
Channel Table, and these are used if the 
channel is not a window. 


Width default 


The SuperBasic WIDTH command 
sets CH.WIDTH, at offset 34 in the 
SuperBasic Channel Table. This defaults 
to 80, which is why the PRINT comma, TO 
and exclamation-mark separators take a 
new line after 80 columns. You can change 
this with the WIDTH command. 

This example uses WIDTH and 
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CHR$(15) to selecta condensed printstyle, 
available on most matrix printers. It reports 
SuperBasic DEF names across 132 col- 
umns: 


OPEN #3,SER1 
PRINT #3,CHR$(15) 
WIDTH #3,132 
VOCAB #3,4 
VOCAB #3,5 
CLOSE #3 


It may be that an incomplete line has 
already been sent to the channel, in which 
case the VOCAB report might start in the 
middle of a line, mixed up with the previous 
output. This is undesirable because it 
messes up the columns, so VOCAB takes 
anew line if the print position does not start 
out at the left margin. 

VOCAB always sends a new line 
when it has finished, like WSTAT, so you 
can tell that it has finished when no names 
are found, and the next thing you send to 
the device does not end up on the same 
line. 


Source code 


Listing one is the assembler source 
code for VOCAB, annotated for study and 
possible modification. | tested this with 
Hisoft’s Devpac assembler, and the same 
source should suit other assemblers too. 
The workings of the assembler code, and 
possible changes, are explored at the end 
of this article. 

You can obtain the original source 
code, plus documentation, on disk from 
DIY Toolkit, at Cwm Gwen Hall, Pencader, 
Dyfed, Cymru SA39 9HA, UK. Send £7 for 
DIY Toolkit Volume X (I’m running out of 
letters!), or call Richard Alexander on 0559 
384574 for details of the 20 volumes now 
available, spanning five years of DIY 
projects in QL World. 

The DATA lines in Listing 2 corre- 
spond to the code of VOCAB. If you do not 
own an assembler you can use the 
SuperBasic in Listing 2 to generate a copy 
of the code. The hex loader is the same one 
used for each DIY Toolkit project; you need 
only type the DATA, from line 590 to line 
790 inclusive, if you already have a copy of 
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the loader. 

The loader checks the DATA state- 
ments and, if they are correct, generates a 
small code file which you can load as 
follows: 


START=RESPR(276) 
LBYTES FLP1 

_VOCAB_CODE,START 
CALL START 


Once you have saved the code to 
FLP1_VOCAB_CODE (or some other file) and 
entered these commands you can use VOCAB 
to report the names known to your system. 


Configuring 


Once the code is loaded to address 
START you can configure it with a few 
POKEs. These are relative to the start of 
the code in memory, and take effect before 
or after you CALL the code. You could use 
SET, from April 1991, to make the value of 
START resident and accessible when you 
have other programs loaded. 

POKE START+13,0 if you want 
VOCAB to list unset names, by default; 
VOCAB 8 still gives resident procedures. 
Youcan POKE any other value from 2 to 8, 
for scalars, arrays, FOR variables, REPeat 
loops, Basic PROCs, FNs, Resident pro- 
cedures or functions. This POKE just sets 
the default type listed. 

POKE START+11 to set the default 
output channel. This is currently #1, to suit 
USE, but you might prefer to divert it to #0, 
#2 or #3, depending on your set-up. 

The most interesting POKE sets the 
column width; values from 2 to 127 are 
acceptable, though 2 only lists the first 
character of each name, with a blank be- 
tween columns! POKE START+143,10 
reserves ten characters per column, suit- 
ing the resident commands in Sinclair roms, 
Toolkit 2, Speedscreen and DIY Toolkit 
extensions. The default of 16 accommo- 
dates Turbo Toolkit, Tascopy, Qlib and 
other packages used regularly, while al- 
lowing reasonable space for SuperBasic 
program identifiers. 


New name 


| might have dubbed this command 
NAMES or WORDS, but decided that these 
terms were likely to be used already as 
SuperBasic definition or variable names. If 
you find VOCAB hard to recall you can 
POKE a new name of four or five charac- 
ters into the code after loading: 


POKE_W START+264,1358 
POKE_W START+266,16717 
POKE_W START+268, 16747 


Turbo Toolkit simplifies this to POKE 
start+265,"NAMES”. Either way, CALL START 
to link the new command under the name 
NAMES. 
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* Sinclair OL World DIY TOOLKIT — VOCAB extension 
* Ver. @.8, Copyright Simon N Goodwin. March i792 


* 
start 


= 


* VOCAB LC # CHANNELZ . 


= 
vocab 


no_hash 


pick chan 


¥ 


bad param 


chan_error 
bad_exit 

= 
one_param 


check_type 


* 
defaults 


chan_open 
x 
get_width 


get_ready 


*# D& is aqutput line wi 


<=. 
got_width 


x 


check name 


lea.i 
move.w 
imp 


MOVED 
moveq 
cmpa.1 
bea.s 
tst.b 
bpi.s 
moved 
move.w 
gsr 
bne.s 
subq.w 
bhi.s 
bne.s 
mOvVe.wW 
Move. wW 
bpi.s 


moved 
bra.s 
meveq 
rts 


tst.i 
bmi.s 
move.w 
cmp.w 


beg.s 


malu 
add.i 
cmp.i 
Boe.s 
move.1 
bmi.s 
movea.t 


movea.i 
moveg 
moveg 
trap 
trap 
tst.1 
bea.s 
mOve.wW 
move.w 
bra.s 


move.1 
move.w 
tst.w 
beaq-s 
bsr.s 
bne.s 


moavea.t 
move.1 
mOovea 
move.w 


cmp.b 
bne.s 
moved 
mOvVe.Ww 
bne.s 
tst.w 
beq.s 
add.1 
move.b 
cmp.b 
bhi.s 
move.b 
subq.b 
move.b 
sub.b 
move.1 


define.ai 
$1lidgcw,ab 
faz) 


Foint at name details 
Use the BP.INIT vector 
Link VOCAB to BASIC 


3 $C NAME _TYPEZ J 


#5.d05 

#1.d7 

as.aa 
defaults 
liad, aé.i} 
no_hash 
#-i.d7 
$1i2.w,az 
fab) 

bad exit 
#2,d3 

bad param 

one _param 
2iai,ad.1),d5 
@(ai,aé.1),d7 
check_type 


#-15,008 
bad exit 
#-6, 08 


day 

pick_chan 
Hlai,ad.1}.,d5 
#1,05 

bad param 


#49,07 

48 (a6) ,d7 
S2(aé),d07 
chan_error 
Hladé,d7.1),0G 
chan_error 


34 (a6.d7.1).dé 
32 (aé,d7.1).,da@ 
gst ready 


(ad) .da 
#(aé,d#.1),dé 
4(adé,d#.1) 
got_width 
do_newline 
Bad exit 


Assume type #8 (RES PROC) 
Assume channel #1 
Any parameters? 


Is there a # prefix? 


Flag it for later 
CA.GTINT — get integers 


Return D@ error code 
Check parameter count 
Toe many parameters? 


Fick up the name type 
Pick up the channel # 
It should be positive 


BAD FARAMETER error 


CHANNEL NOT OFEN error 
All errors exit here 


Was there a # prefix? 

Parameter is channel # 
Parameter is name type 
Check for expressions 

Reject, no name 


Find offset in table 
fidd base tae offset 
Check nat beyond end 
Number is toc high 
ID for output window 
Channel is clased 
Set up Channel iD 


Point Al at BASIC Buffer 
Wait indefinitely longa 
SD.CHEN@ trap key 

Ai is an AG offset 

Cail Odos 

Z signals ERR.OK 


Pick up CH.WIDTH 
Fick up CH.CHFOS 
are we on a new line? 
Find the buffer again 
Fetch the window width 


Is the cursor at left? 


No} move to a new line 


@th, DS is name type. A®@ is ID 


24(a6),aS 
28 lab), a4 
#16,d7 
dé,d4 


@laS,ab.1),d5 
next_name 
#8.d01 
2(aS,aé.1),d1 
net_null 
#as.ad.1) 
next_name 
B2(ad).di 
Blaé,di.1),da 
d@,d7 
easy _ fit 
d7,daa 

#1,08 

d7,d2 

da,d2 

(a6) ,az 


@S —> Start of Name Table 
44 -> End of Name Table 
Column width (1..i27) 

D4 is room left on line 


Check the type of name 


Clear high word of Di 
Find Name List offset 


Is this a null entry? 


+ Name List base address 
Get name length (i+) 


It fits the column width 
Emulate Frocrustes 
Allow at least one space 


D2 is number of spaces 
@A2 is buffer affset 
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Code commentary 


Listing one reveals the inner workings * DG is length to copy toa buffer from i1(Aé,Di-L) 
of the VOCAB command. If there is only x 
one parameter, a channel number is dis- copy_name they pert ear ft oa nes 
7 ‘ adda. ; vance roud ame Lis 
tinguished from a Name Type by the addq.i #i,aZ Advance through buffer 
presence of ahash prefix: VOCAB #0 lists subq-b #1,0a Count one less character 

i bhi.s copy_name 

the default type ab channel #0, while pad_ spaces move.b #32,@ta2,a6.1) Add one space to buffer 


VOCAB 0 lists unset names to the default addqsi #i,a2 AUVaGeEEnESUGgH BUFAER 
channel. subq.b #1,d2 Count one less space 


Unfortunately the vectored routine pear pad [Spaces 


= 

that counts and evaluates the parameters * There are D7 bytes ready to be output from offset (Aa) 

also scrubs the separator details, so we * ; : JOE 
need to look for the hash before calling es eee En ae Se a 
CA.GTINT. The program sets D7 toa bsr.s do_newline Take a new line 

negative value if the hash is found; D5, D7 bne Bad exit "4 od 

and A4 are the only registers left intact by seep SunDOn eacinDen: 

CA.GT routines. they fit  movea-1 4b). Foint at the text 

The number of parameters winds up ele f ansecee areeuace 

in D3; D7 is checked if there is only one, tap Naverat Go antlorrset 
otherwise the supplied values are loaded trap Send the string 

and checked. Name Type 1 gets ‘bad pa- oe Pan Serra 

rameter’ as expressions have no names. next_name addq.1 7a Advance down Name Table 
The channel must be open in the cape. 4 Have. we weached, the end? 
. ‘ bhi.s Keep going if A4 > AS 
SuperBasic Channel Table, or a ‘channel a ASiibe. meveq : Newline ASCII code 


not open’ error results. maveq ‘ IQ.SBYTE trap key 
trap 

tst.1 Flag the errer code 
rts 


Cursor position 
dc.w One new PROCedure 
Once the channel ID is known we res 5, "VOCAB? 

need to check the width and current cursor He. 529,0 End of PROCS. gq. Ths, 
position. Display and window channels oy 

must be treated differently. The code at 
GET_WIDTH calls SD.CHENQ to read the 
cursor position in characters, but this only REMarkeeie ean eda er serempinsy 3 
works if the channel is a window; otherwise REMark by Marcus Jeffery & Simon N Goodwin 
the information comes from CH.WIDTH : 


i i CLS: RESTORE : READ space: start=RESPR(space) 
and CH.CHPOS, held in the SuperBasic PRINT “LeadiiHes i) “12 HN TOAD stare 


Channel Table. 74 INPUT “Save to file..."if% 
Similar code is used in PRINT and SBYTES f£$,start, byte + STOP 
INPUT when processing comma, TO and @ DEFine FuNction DECIMAL(x) 
exclamation-mark separators. This ex- RETurn CODE(h$(x))—48-7*(h8(x)>"9") 
plains why the WIDTH command has no END DEFine DECIMAL 
effect on display output; itis over-ridden by DEFine PROCedure HEX_LOAD(start) 
the window details. byte = @ : checksum = 9 
VOCAB moves to a new line unless a eo ar tices 
the cursor is already at the start of a line; IF h$="*" : EXIT load_hex_digits 
SD.CHENQ activates any ‘pending newline’ IF es vee Se Pra | rere 
which may have been sent to the window adie nein i a 
but not yet performed. 
At T WIDTH we pi the 1 TO LEN(h$) STEP 2 
beund bis N T sti sited by = DECIMAL(b) : 1b = DECIMAL(b+1) 
ounds of the Name Table, which will be IF hb<@ OR hb>15 OR 1b<@ OR 1b>15 
searched for the required type of name, in PRINT"Tllegal hex digit in: "jhe : 
; : END IF 
D5. Notice how D1 is cleared before the PGKE sbanhibste. la*hbalh 
Name List offset is fetched; this means that checksum = checksum + 16*hb + 1b 


unsigned offsets in the range 32768-65535 axe ae = byte + 1 

are correctly processed. END REPeat load_hex_digits 

READ check 

a IF check <> checksum 

Null entries E PRINT"Checksum incorrect. Recheck data. ": STOP 
END IF 

PRINT"Checksum correct, data entered at: ";start 


Null entries in the Name Table are END DEP ibe ee 

skipped. This check prevents the first name REMark Space requirements for the machine code 
in the Name List appearing one or more DATA 276 

times in the report of unset variables, when j 
VOCAB comes across unused Name Ta- 
ble entries, which consist of eight zero 
bytes. These redundant entries are 
sometimes created when the Name Table 
expands, and cleared out later by NEW. 


Sinclair/QL World September 1992 35 


DIY TOOLKIT 


Each name is copied to the start of 
the SuperBasic Buffer, followed by spaces 
to fill it to the column width. Long names 
are cut short to fit. This approach is simple 
and efficient, although it might seem less 
elegant than writing the name from the 
Name List. 

There are always at least 128 bytes 
available in the Buffer, and it’s usually 
quicker to write the whole string from one 
place, rather than as two parts, name 
followed by padding spaces. The extra 
spaces at the end of each line are redun- 
dant, but keep the last column tidy if win- 
dows overlap. 

As each column is output VOCAB 
counts the number of spaces remaining on 
the line in D4; if this becomes negative the 
line is full and the loop calls DO_NEWLINE, 
before setting D4 to the line-width minus 
the space needed for the column waiting in 
the Buffer. 

Once all the names have been 
scanned, VOCAB falls into the 
DO_NEWLINE routine, which sends the 
new-line code CHR$(10) to the device and 
returns to SuperBasic. 


Further options 


The code for VOCAB could be ex- 
tended in several ways. An extra string or 


619 REMark Machine code data 

620 DATA "43F4919234780116", "4ED27AQ87EG1BBCB" 
630 DATA "“67364A33E8916A@2", “7EFF347801124E92" 
640 DATA "66165543628C6612", "3A31E8@023E31E800" 
65% DATA "6A1@7OF169027OFA", °4E754A876BEE3A31" 
66 DATA "E8@Q@BA7C@OG167EA", "CEFC@G28DEAERGG30" 
670 DATA “BEAR@2346CE@2036", "78@G6BDA2G4G2256" 
680 DATA "76FF79@B4E444h43", "4A8G@67GA3C367822" 
69% DATA "3G36782969GA2016",, "3C36G8SG4A7698H4" 
786 DATA "67@4617666B2266E", "@G18286EQ@1C7E1G" 
718 DATA "38@6BA33E8@@665C" , "72063233E8G26606" 
728 DATA "4A73E8@@674ED2AE", "@G2G1G3618GGBESS" 
730 DATA "6204199753001497", "9499245615B61891" 
749 DATA "EH8@@5281528A5300", “62F215BC@@29E8g0" 
75@ DATA “528A53@262F49847", "GAZAG11E66Q@FF5A" 
76@ DATA "38@6984722563497", "70074E4448434A80" 
778 DATA “66@OFF465@8BB9CB", "629872GA79G54E43" 
78@ DATA "4A8@4E7590G1FFO4", "@5564F4341420900" 
790 DATA “O@BPPSPIOS" . "*" , 22572 


‘wild-card’ similar to that used by WSTAT, 
so that only names which match a certain 
prefix appear in the report. In some cases 
it might be desirable to output the names in 
sorted order, or include other information 
such as the Name Table index of each 
identifier. 

The defaults presently determined 
by POKEs could be controlled by new 
commands, VOCAB_COLS, 
VOCAB_TYPE and so on, which modify 
the relevant code bytes or data values 
stored separately. This is tricky if you want 
the code to work in rom, as the options 
must be stored ata reliable address in ram. 

| am always interested to hear of 
suggestions or modifications for published 


umes for the best suggestions. Please 
write to me, care of QL World. 


VOCAB parameters 


VOCAB 0 Unset Names 
VOCAB 1 Bad Parameter 
VOCAB 2 Scalar variables 
VOCAB 3 Dimensioned variables 
VOCAB 4 SuperBASIC 
PROCedures 
VOCAB 5 SuperBASIC FuNctions 
VOCAB 6 Used REPeat loops 
VOCAB 7 Used FOR identifiers 
VOCAB 8 Resident Procedures 
VOCAB 9 Resident Functions 


unset name parameter might specify a 


DIY Toolkit code, and offer free DIY Vol- 


f IF Services FF 


MINERVA 


The ULTIMATE operating system upgrade 
MELT MINERVA now with battery for 256 bytes 
rom, CRASHPROOF clock & interface (I'C) for 
robots etc. Can autoboot from battery ram, 
Uther features common to MKI/MKIID: 
Autoboot on reset/ Multiple Basic/ Faster 
scheduler-graphics (10% of Lightning)-string 
handling etc? WHEN ERROR’ Second screen/TRACE 
Foreign kybd drivers/ ‘Warm’ fast reset etc 
NET to MKT UPGRADES: up to 1,79-2£5, Rest FREE 
ésend rom (PROTECT LEGS!) and disk or 2 mdvs) 


OBES - The first UK QL scrolling bulletin 
board. Now even larger with international 
ECHCmail and 1@mb of files (including 
the WHOLE King James’ bible!) 


Viewdatas¥I52/YT100 OL TERMINAL EMULATOR 


Multitasking for electronic mail, PRESTEL etc, 
CET dounload. Compatible with Tandata Gconnect 


» Use Aconnect R$232C to drive 
comprehensive AS manual, 


QL modem/modapt 
unbuffered moder 


Software (3.5" or ndv) & manual ff 
FILE TRANSFER - to transfer text AND programs 
error free CRHODEN) betueen computers 


Available for IBM compats, ATARI ST & Sinclair OL 
Connects to Psion range with RS232C comms link 
Software £7.58 per m/c. Cable £18 (name 2 m/cs) 


All prices include YAT und postage in the UK 


E27 - 6 month guarantee 


{2 Bouverie Place, London 2 1RB 


SCROLLING BBS FOR ORDERING/QL HELP and FAX - 871-786 2379 


HERMES 


fA replacement OL co=precessor (IC 8049 IPC) 


Bo you get keyboard bounce? 
Do you find Fast serial input uareli able? 
Do you want to run an HST 14460 bps noden? 


If you can say YES to any one of these, then 
this is a product you have been waiting fer 


Gives up to 19208 bps RELIABLE serial input 

+ Independent baud rates 

+ Stops keyboard ‘bounce’ (unwanted repeat chrs) 
+ Improves ‘fuzzy’ and ‘random’ sound 
Provides extra input and output lines 

Key click 

*Reset/INT? invoked more safely 


FITTING is a simple job. Simply remove the 
QL top (8 screws) and replace the chip marked 
“9849 next to microdrive 1, 


PRICE (including manual & softyare) £25 
QL SPARES 


Faulty @L boards ¢excl plug in ICs: 
Keyboard membrane... £8 Circuit di 


JM rom set... 
+» E10 8381 ULA. 
>» £8 MOU ULA 


Other components (sockets etc)... plse PHONE 


QL REPAIRS 


QLs tested with Thorn EMI test rig 
and ROM software 
(NDV harduare extra if required) 


MAIL ORDER ONLY ° 


(tals 71-724 9053) 


* SINCLAIR 


O21 x 
STOP PRESS 
Serial 3 Button Mouse 5 


Remote Infra Red Mouse $55 ae 


Externally fitted into SER2, comes complete with interface and software. No 
Internal fitting required, 3 button mouse gives 5 more functions than the QIMI. 


A SERIAL MOUSE FOR THE QL AND 
SER Mouse the Mouse Driver 


The SERIAL MOUSE SYSTEM enables a mouse to be used with the QL 
by simply plugging the mouse into the SERIAL 2 Port, and running a 
BOOT program. Common to all Mouse Systems, programs with a 
Pointer Environment are required. 


Four Packages are on offer 
1. 3-BUTTON MOUSE. SER Mouse 3.5 SOFTWARE. D-9pin to QL 


ADAPTER FOR THE SERIAL PORT. INSTRUCTIONS. = £45 
*1A. AS FOR 1 ABOVE, but including PC MOUSE DRIVER DISK. 

£12 extra 
2. CORDLESS (INFRA-RED) 3-BUTTON MOUSE. SER Mouse SOFTWARE. 
D-25pin to QL ADAPTER FOR THE SERIAL PORT. BATTERIES & 
INSTRUCTIONS £55 
*2A. AS FOR 2 ABOVE, but including PC MOUSE DRIVER DISK. and 
‘VISULIZER’ a PC Mouse Painter Program on 3.5 and 5.25 disks. 

£18 extra 
* While stocks last. 


NB. We still have lots of QL’s, 1 & 2 Mb disk drives, peripherals and components. 
See previous adverts or contact us for details 


EEC LTD 


18-21 MISBOURNE HOUSE, 
CHILTERN HILL, 
CHALFONT ST PETER, 
BUCKS. 
SL9 SUE 

Tel: 0753 888866 


Paymentterms: 

CWO, Access, VISA ef cetera 

Cheques - allow 10 days meatal 
Delivery: E 
Postage - £3 = 
Product subject to availability. E&OE. 


Fax: 0753 887149 
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ONE NIAN'S 
SYSTEM 


A stroke of genius? David McCullagh has trained 
Archive to keep his competition team (and its 
accounts) going swimmingly. 


now seems a lifetime ago 
when | first took delivery of 
my QL. | was locked away for 
| weeks coming to terms with 
Quill and Abacus. Archive 
seemed beyond me. Initially 
my main uses were report and letter writing 
and basic accounts. The furthest | got with 
SuperBasic was writing boot programs. 
My Medic experiences are long gone 
and my setup now includes a JS QL with 
an 896K Trump Card (soon to be replaced 
with a Gold Card), Lightning, a Care 
regulator, Miracle hard disk and Miracle 
3.5in drives, a Keyboard 90 IF, a PC-type 
keyboard, a Philips Green Screen, recently 
an EEC Sinclair Colour Monitor, and a 
Star XB24-10 printer. | had intended to put 
all the QL parts in a Spem box but with the 
arrival of the hard disk, | will have to look 
at a PC-type housing. | also have a twin- 
floppy Thor 8. It was in constant use, but 
its limit of 640 K andi its inability to take any 
extra hardware now makesittoo restrictive. 
Aside from various spare parts which will 
someday form a backup QL, this is my set 
up at home. 
At work | have a twin-floppy Thor 
XVI with 1 MB, a Philips Green Screen and 
aStar NL 10with sheetfeeder. All machines 
use a Miracle Centronics interface. Boards, 
roms, power supplies, etc. have been 
replaced on all machines over the years, 
but my soldering has not improved! | have 
tried to network the machines as per QL 
World and Quanta articles but without 
success. | will try again, so that | can use 
a backup QL as a print buffer for the many 
long printouts | make. 


Demise and reprise 


| had thought that my ideal machine 
was a Thor XVI with 1MB, and a 40 MB 
hard disk. Regrettably with Dansoft’s 
effective demise this is not very practical. 
The Gold Card and the plans for a Super 
QL seem the only realistic option. So the 
future still looks bright. 

My software experiences give truth 
to the adage: ‘You use 10 per cent of your 
software, 90 per cent of the time’. My main 
programs now are Cowo’s Qfop, Psion 
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Xchange, Archdev, Abacus, Perfectionand 
The Editor. Lightning and Toolkit II are of 
course installed. My wishes are for a good 
but flexible accounts package, and for 
Xchange on the QL. | have Cash Trader, but 
could not get it to do exactly as | wished. A 
good Abacus spreadsheet covers wages. 

My main job is as manager of a 
sports centre in Dublin, while my second, 
unpaid, job is as manager/coach to a 
national level swimming club. In the former 
role | use the QL/Thor to write letters, 
reports, andso on; | write Archdev programs 
to maintain bookings/invoicing information 
and to maintain records, produce invoices 
and membership listings, and that sort of 
thing. 

The first of the main database 
programs | use is the Bookings Module, 
which takes information from groups who 
hire our facility, calculates term lengths 
and the costs involved, and produces 
invoices. | can produce lists of groups who 
start or end in a certain month, who owe 
money, when they paid, etc. | store the 
start and end dates in two forms. The first 
is dd/mm/yy, and as this is difficult to order, 
| also store it numerically by adding the ‘dd’ 
to ‘mm’ x 31 to ‘yy’ x 365, giving a number 
such as 726913. This permits the file to be 
ordered on start or end date and, by using 
the INT function, | cancalculate the number 
of days in a term. 


Books and accounts 


Three database files are used for 
‘bookings’. The first ‘d’ contains the details 
of the groups, such as names and 
addresses. When a group starts a new 
term, this information is taken from ‘d’ and 
passed to ‘b’ where the actual term details 
are added. A third file ‘c’ contains just one 
record, the current invoice number. 

The next database is a very basic 
accounts program. We use acash register 
which produces daily readings. Our auditor 
requires apage per reading, sothe readings 
are entered into acomputerised Day Sheet 
which simply stores the readings for Income 
and Expenditure and gives a daily balance. 
These are then printed out each month. A 
second file is maintained which, when the 
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last day of each month is reached, creates 
a Month Totals File. This file will then 
contain 12 or maybe 15 records, if | wanta 
six and twelve month total. 

| planto expand this to accept cheque 
details and lodgements. The last stage 
would be to combine this information to 
produce amonthly Income and Expenditure 
Sheet with current balances. My knowledge 
of accounts is very limited, so producing an 
Audit is beyond me and not really useful to 
me. 


Stock control, etc., are not bigissues 
and you have to be careful not to waste 
time on a computer if a manual system is 
quicker and functional. 

In my work as manager/coach, | find 
even more use for a computer. The club 
has over 100 members and, being a sport 
based on timing, their recordings are 
essential. The first of three databases holds 
all current best times of each swimmer, the 
Personal Best Module. The file is 
constructed so that each record contains 
all of aswimmer’s events and times. | could 
reprogram to use a record for every event 
and time for each swimmer, but aside from 
the great size of such a database, it is 
limiting, without a lot of programming, to 
produce one sheet with each swimmer’s 
event profile. 


Controlled fields 


There is also the point that there are 
a set number of events in swimming, 
therefore the number of fields in the 
database is controlled. Again the format of 
menus is used with a ‘sedited’ screen doing 
much of the work. 

The second club database is the 
Clubil Module. Swimmers pay monthly and 
annual fees, and also take part in 
competitions for which entry fees are 
chargeable. Here | chose a different 
approach, in that every entry becomes a 
record. This leads to a large database, 
almost 5000 files, but it allows more 
manipulation of the data, and as the entries 
per swimmer increase there is no danger of 
running out of fields. A details file (‘d’) is 
kept, holding names, etc., and the 
swimmers’ account balance. Every time an 
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Proc bilbac 
REM Called by Shutdown to save dbf from Ram to Flp or Win 
SHOWHEAD : 
while not instr("YyNn",cont$) :input at 9,5;"Continue (y/n) 


Wm, 
, 


if instr("Nn",cont$) : endif : endwhile 


print at 15,5;"Another copy/Restart/Quit (a/r/q)? "sans 


i | lL. AF Fel |e mh 


local cont$,an$ : print at 5,5;un$;"Save Files...";un$ 


if instr("Yy",cont$) : kill fnl$ : kill fn3$ : kill fn5$ : print at 11,5;"Now saving..." 
backup £n2$ as fnl$ : backup fn4$ as fn3$ : backup fn6$ as fn5$ : endif 
: while not instr("'AaRrQq'',an$) 


if instr("Aa",an$) : SELDEV : BILBAC : else : if instr("Rr",an$) 
else : if instr("Qq",an$) : kill fn2$ : kill fn4S : kill fn6$ 
QUIT : endif: endif : endif : endwhile 

endproc 


conts 


: START1 


kJ] 


Proc mmenu 


REM Calls Procs after input from Showmenu. Set "mm<" to last option +1 


endproc 

| | | | 
Proc seldev 
REM Select Data Device, choice of Flpl_, Flp2_ or Winl_ 
SHOWHEAD : let dv$="" : let dev$='' 
print at 10,10;"A Flpl_" +sprint.at.11,,10:"B Flp2.t' 
print at 12,10;"C Winl_" : while not instr("AaBbCc",dv$) 
input at 20,10;"Select Device (a/b/c) ; ";dv$ 
if instr("Aa",dv$) : let dev$="flpl1_": else : 


let dev$="flp2_" : else : if instr("Cc",dv$) : let dev$="winl _" 
endif : endif : endif : endwhile 
endproc 


1 1 1 1 1 if if i 
Proc showhead 
REM Screen Message 
cls : print ;"TEMPLEOGUE SWIM CLUB - Invoice Module" 


endproc 


while mm<11 : if mm=0 : SHOWMENU : else : if mm=1 : INMET : FINDS : ENTRY 

else : REM repeat "mm="" for other ShowMenu options 

if mm=10 : SHUTDOWN : endif : endif : endif : SHOWMENU : endwhile 

endproc 

Snes 2! Miner Hone lawibieel bneiaiinene’ sucwehl peerite 

Proc orcb 

REM Called by START1, opens Raml_ files 

open fn6$ logical "cl": open fn4$ logical "d": open f£n2$ logical "b" : sload fn8$ 


: print at 5,10;un$;"SELECT DATA DEVICE";un$;dv$ 


if instr ("Bb",dvs) 


; tab 60;"Date ";today$s 
print tab 60;"Time ";time(): print tab 60;"Kbytes "; (memory())/1000 


ArchRtm or Run-Time Archive. The 
advantage of ArchRim is that it is faster 
than Archive/Archdev in loading, etc. The 
disadvantage is that Esc (unless it is 
trapped), causes the program to quit. It 
was meant to be used by commercial 
suppliers, as it tokenises code and users 
cannot access the programs. You must 
write _prgs in Archdev to use them in 
ArchRim, so it’s as handy to use Archdev 
all the time, although | notice no advantage 
using it over Archive. 

Archive is a bit daunting at first but | 
found that with help from Chas Dillon 
through his Quanta Notes booklet (which 
aside from being ideal to learn how to plan 
alarge program gives many useful tips and 
information not available elsewhere, on 
Archive), Mike O’Reilly’s Database 
Management on the Sinclair QL, Albert 
Russell's Managing data on QL Archive 
and Malcolm Johnston Advanced Archive 
on your Sinclair QL, that | can now write 
passable programs. | know that my coding 
is long winded (some listings reach 600 
lines) and with more knowledge it could be 
more efficient, but | find that it works. In 
fact, the main problem is Archive's lack of 
speed in selecting, searching, etc. | have 


entry in made, the ‘d’ data is appended to 
the ‘i (Invoice) file, the entry details are 
made, and the ‘d’ file account balance is 
updated. An invoice is then issued to each 
swimmer monthly. 

The third Module is used by both the 
previous two. The Details Moduleholdsnames, 
addresses, phone numbers, etc. In itself, it is 
simple in that it is a flat file with one file per 
swimmer added or deleted. However, it is 
central to the other two databases. 


Sorting swimmers 


A future project is to rewrite the 
Personal Best Module along the lines 
mentioned, of one file for each swimmer’s 
event. The reason for this is that many 
competitions have qualifying times. With a 
file per event, it would then be possible to 
call on all swimmers of a certain age who 
are inside a certain qualifying time (stored 
in a further database). It would also make 
ranking the swimmers easier, such as 
fastest to slowest in an event. 

| use Archdev because the Archive 
system of Xchange is, in fact, Archdev. | 
also use it because | sometimes use 
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looked at Flashbackand others, but Archive 
wins for me because of the limitless tasks 
that its programming language can help 
achieve. My coding may also be long 
winded because | never finish a program! 
Well, | do, but then | start fiddling and see 
additions that can make and improvements 
in coding, sometimes years later. 


Helpers all 


l use the same basic system to write 
all my programs. | ‘borrowed’ it from Chas 
Dillon. The listings | have included indicate 
the skeleton _prgs | use. | start up with 
something like “Run Object ‘flp 1"", where 
Clubil is a _prg file saved with ‘object’ to 
become _profile, making for faster loading. 
‘Run’ requires a procedure called Start. 
Here | set up variables, then pass control to 
Seldev which gives a value to dev$, so that 
| can load data files from floppy or hard 
disk. It also gives a value to fn1$, etc., 
which are the global filenames. The files 
are backed up to ram, opened using ORCB 
(‘open ram club bill’) and control is passed 
to Showmenu, which is the programs ‘front 
end’ or menu from which non-printing 
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options are selected. 

| have included a few options in the 
listing, but you can have as many as you 
wish. On selecting an option, control is 
passed to MMenu, where the option 
selected is passed to the procedure 
controlling that option. | have not listed the 
details of these, as they are specific to 
each application. However, the most 
common ones resetall variables ina record, 
call a screen (sedited), ask for input using 
Sinput, then if you confirm that the 
information is correct, the record is 
appended to the database. 

Selecting option 9 calls up asubmenu 
which operates like Showmenu but which 
controls all output to the printer. In Clubil, | 
can print out all due invoices, select one 
member and print out a due invoice, print 
out all account balances etc. When printing 
is completed, control is returned to 
Showmenu. 

Selecting 10 from here leads to 
Shutdown. This procedure closes all files, 
then calls Seldev to select the device to 
which Bilbac will backup the ram based 
data files. Normally it’s still the same device, 
but | always keep two copies of data files so 
| can Bilbac to flp 1_ and when completed 
| can Bilbac to flp 2_, thus saving disk 
changes. Also as | have ahard disk athome 
and none at work | don’t have to switch to 
SuperBasic and WCopy RAM1_dbf, 
WIN1_dbf, Seldev offers me the option to 


copy to WIN1_. On completing the backup, 
lcan return to Showmenu or Quit. Although 
| have not had lockups or crashes in along 
time, thanks to Care’s power regulator, | still 
like to backup every 15 or 20 minutes. Good 
habits save a lot of tears. 

Using this system, | never leave a 
session without choosing Option 10, and 
so never have problems forgetting to close 
files. In fact, | have had no file corruption in 
avery long time, in part because all work is 
done in ram (which is the fastest way of 
manipulating data in Archive), and in part 
because of option 10, and also, | think, 
because | don’t use microdrives. 

| am weak on using parameters in 
Archive procedures. | know they reduce 
coding and are faster, but | never got the 
hang of them. Soon | will take a week off, 
rewrite the programs and use parameters 
- when the rush is over! 

| have been told that PC-type 
databases such as DBase require good 
programming skills and just as much 
frustration as Archive. Archive is limited in 
that it is difficult to get to grips with initially, 
and itis relative slow but overall | have not 
yet found any serious job which it could not 
handle. Compared with today’s databases, 
it does not have graphics, menus, etc., but 
it is free. | see that PC Archive will costs 
nearly £300, and | have not heard any 
plans to convert it for use on the QL. 

| have always though that the main 


ONE MAN'S SYSTEM 


uses of computers were for word processing 
and database activities, and | find it 
surprising that no one has made a serious 
attempt at producing a better Archive/ 
DBase-type of database for the QL. 


PC not for me 


| had considered moving to the PC 
world, but experience with one, the 
investment | have in the QL, and the very 
high cost of PC software put me off. With 
the arrival of the Super QL, either through 
putting ittogether yourself or buying one off 
the shelf, the QL looks stronger than ever. 
The other evening | stopped, struck by the 
versatility of switching from The Editor to 
SuperBasic to Perfection to Archdev, etc., 
all in 1 MB. | know PCs can at last do 
similar, but not as easily nor as cheaply. 

Beingin Ireland where there is no QL 
supplier, and where anything you can getis 
very expensive, and! am indebted to people 
such as Chas Dillon, Freddy Vachha and 
Digital Precision, QL World, especially 
Simon Goodwin, Bryan Davies, Miracle 
Systems and many Quanta members 
without whom | would never have gotten 
this far. My thanks to you all. 

If any readers want listings of any of 
my programs | will be happy to supply 
them, but there are few rem statements 
and deciphering them may be difficult. 
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Robin Stevenson 
brings to book a 
bibliography 
routine - but it has 
many other uses as 
well. 


you have ever written some se 

rious non-fiction, the chances are 

you stuck a bibliography at the 

end (nicely put, Robin). Whether 
it’s a school or college essay, a four-page 
village history, or a full-blown book, you 
should provide one, both to list your 
sources. and guide the reader for further 
information. 

If you are already a database 
fan, then you won’t need me to tell you that 
the best way to compile your bibliography 
is to computerise it. Allthe classic database 
elements are there: a mass of disparate, 
but structured information (authors, titles, 
etc.) to be placed in alphabetical order, 
and presenting in an orderly manner. The 
first part of that process is a simple Archive 
problem. Identify the various fields you will 
need, insert the data, and use the ‘order’ 
command to put it in order. 


Extraction 


As with most databases, the tricky 
bit is extracting the information in the way 
you want it. If the bibliography is just for 
books, the situation is fairly simple. You 
print out the author, title, publisher, and 
date, with suitable punctuation inserted. 
But there are complications. The refer- 
ence may be to a chapter in a book edited 
by someone else. So the editor, and the 
overall title need to be included. It may be 
an article in a journal, in which case the 
journal name and issue number should be 
included. There are other formats for 
newspapers, legal documents, etc., but 
we shall restrict ourselves to these three. 
You could add other specialist headings 
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BIBLIOG PRG - Listing for Bibliograhy Database Management. 


ARCHIVE 


A=N+S-W=E+R-S 


proc NewFile;File$ 
create File$ logical "bibliog" 
Author$ 
Titles 
Year 
Publisher$ 
City$ 
Compilation$ 
Editor$ 
Journal$ 
Issue$ 
Comment$ 
UseThis 
endcreate 
endproc 


proc Identify 
reset : order Author$;a,year;a: display 
print at 13,12;"Include this Record? Y/N: "; 
while not eof() 

sprint : print at 13,40;""; at 13,40; 

let answer$=upper(getkey()) 

if answer$<>"Y": let answer$="N": endif 

print answer$ 

let UseThis=(answer$S="Y") 

let bugfix=recnum(): update : position bugfix 

next : endwhile 
endproc 


proc IncludeAll 
reset : first : while not eof() 
let UseThis=1 
let BugFix=recnum(): update : position BugFix 
next : endwhile 
endproc 


proc OutputTo;X$ 
if upper(X$)="P": spooloff 
let Ucode$=chr(16) 
let LeftMargin=10 
let WrapMargin=18 
let RightMargin=70 
return 
endif 
if upper(Xx$)="S"; spoolon screen : cls 
let Ucode$=chr(5) 
let LeftMargin=3 
let RightMargin=61 
let WrapMargin=11 
return 
endif 
spoolon X$ export 
let Ucode$="" 
let LeftMargin=0 
let RightMargin=80 
let WrapMargin=0 
endproc 


proc PrintInit 


let CurrentMargin=LeftMargin 
let CurrentPos=LeftMargin 
let Underlining=0 

endproc 


proc PrintLine;Xx$ 
local Pos ,Max,H$,Sep$,Uline$ 
let Sep$="_-,.3:""!7)" 
if Underlining: let Uline$=Ucode$ 
else : let Uline$="": endif 
let Max=RightMargin-CurrentPos 
while len(Xx$)>Max 
let Pos=Max: if pos>1 


while not instr(Sep$,X$(Pos)) and Pos>Max-10 and Pos>1 


let Pos=Pos-1 
endwhile : endif 
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yourself if required. 

Finally each entry needs to be 
correctly formatted. The name needs to be 
‘outdented’ from the rest of the text, and 
lines need to be wrapped around properly. 
Quill does all this without a murmur, but 
Archive needs a little persuasion - in this 
case, via a slightly tortuous, but wholly re- 
usable Archive procedure. There are also 
procedures to create a file, and extract the 
bibliography details. As a little embellish- 
ment, it allows you to select only part of the 
list before printing it out. You can build up 
a comprehensive reference on a subject, 
and only include the entries you require for 
a particular publication. 

Your complete bibliography could then be 
a valuable research aid, using the normal 
Archive locate, search and find facilities. 
There is plenty of scope for adding to 
these features. You could add a field to 
record where the book is kept (‘shelf 
3b’,’loft’,’ reference library’, etc.). And if 
books are not your 

thing, it would be very easy to adapt the 
program to organise your record collection, 
photographic slides, or whatever, with fairly 
minimal changes to the program. 

Once the listings are entered, 
debugged and saved to disk/microdrive, 
you can start to enter your data. Rather 
than providing a complete program shell, 
we shall use the Archive ‘Command Line 
Interface’. Don’t let that phrase panic you. 
It just means typing commands at the 
normal Archive prompt. Some of 
these will be standard Archive commands 
(such as Insert, or Close). Others are the 
program commands such as NewFile or 
PrintList. In case you forget the commands, 
there is a ‘help’ command, which will de- 
scribe the commands (both Archive and 
Bibliography) you may need. 


Using it 


Once you have tried it, the pro- 
gram should seem quite simple. Here is a 
brief description of how to use it. To create 
a new data file, you enter: 


NewFile; filename’ 


choosing a filename that describes its 
contents. When you return to a previously 
created file, you can use the standard 
Archive command Open ‘filename’instead. 
You can now enter details of the books you 
wish to include, using the ubiquitous ‘In- 
sert’ command. Obviously you can keep 
returning to a file to add extra books, as 
your research/enthusiasm grows. For each 
entry you will need to decide which of the 
three entry types it is, as the different 
types use different data fields. All types 
should include the author (or authors all on 
the same line), the title of the piece, and 
year of publication. If it is a journal/maga- 
zine article you should leave the next few 
fields blank, and add the journal name, and 
details of the issue and page numbers. 
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if Pos<=1: lprint : else 
if not instr(Sep$,X$(Pos)) and len(X$)>Pos+7 
let Pos=Pos+7: let H$="-" 
else : let HS="" 
endif 
lprint tab CurrentMargin;Uline$;X$(1 to Pos) ;H$;Uline$; 
let CurrentPos=CurrentPos+Pos 
let X$=x$(Post+1 to ) 
while X$(1)="_" and len(X$)>1: let Xx$=x$(2 to ): endwhile 
if x$="_"r let X$="": endif 
if len(X$): lprint : endif 
endif 
let CurrentMargin=WrapMargin 
let Max=RightMargin-CurrentMargin 
if len(X$): let CurrentPos=CurrentMargin: endif 
endwhile 
lprint tab CurrentMargin;Uline$ ;X$;Uline$; 
let CurrentPos=CurrentPos+len(x$) 
endproc 


proc Book Br 
let Underlining=1:Printline;Title$: let Underlining=0 F ry 
PrintLine;" ":PrintLine;Publisher$+" ":printLine;"("+City$+") 
endproc 


proc Journal 
PrintLine;Title$+". 
let Underlining=1:PrintLine;Journal$: let Underlining=0 
PrintLine;" "!PrintLine;Issue$+". " 
endproc 


" 


proc Compilation 
PrintLine;Title$+". 
PrintLine;"In "+Editor$+", editor, 
let Underlining=1:PrintLine;Compilation$: let Underlining=0 
PrintLinej" "!PrintLine;Publisher$+" "sprintLine;"("+tCity$+") " 
endproc 


" 


" 


proc PrintEntry 
PrintInit: lprint :PrintLine;Author$+", 
if Editor$="" 
if Journal$= 
Book 
else :Journal 
endif 
else :Compilation 


" 


ret 


endif 
PrintLinejstr(Year,2,0)+". ":PrintLine;Comment$: lprint 
endproc 


proc PrintList 
local Spool$ 
print at 13,0;"Send To [P]rinter [S]creen or enter filename: ig 
input Spool$:0utputTo;Spool$ 
order Author$ja,Year;a 
select UseThis>0 
first : while not eof() 
PrintEntry 
next : endwhile 
spooloff 
endproc 


proc Help 
els : print 
print " BIBLIOGRAPHY DATABASE" 
print 
print " To Create a new file, NewFile;<filename>" 
print To Open an existing file, Open <filename>" 
print To Insert new records, Insert" 
print To Identify the required records Identify" 
print To Include the entire database IncludeAl1" 
print To Print the bibliography PrintList" 
print To Close the file after use Close" 
print 
print " To modify margins, Edit the procedure ‘QutpuTo'" 
print " To modify underline codes, Edit procedure ‘OQutputTo 


endproc 


41 


ARCHIVE ANSWERS 


Ifitis a book, the journal informa- 
tion is left blank, but you should add the 
publishers name, and city of publication. 
And if it is only a chapter in a book com- 
piled and edited by someone else, you 
should include, in addition to the publisher 
information, the editor’s name(s) and the 
overall title of the 
compilation. 


Fairly crude 


The printing routine uses the 
fairly crude technique of seeing which 
fields are blank to decide which type of 
entry it is. So make sure you don’t acci- 
dentally add spaces or other characters to 
fields that should be blank. Punctuation 
between entries is added automatically, 
so you should not duplicate this. The 
exception is within names of authors and 
editors. Names should be entered sur- 
name first, followed by acomma, and then 
initials, followed if desired by a full stop. 

Finally, there is an optional 
‘Comment field. This is particularly useful 
if the bibliography is for ‘suggested further 
reading’. You can use this to point out 
particularly important books on a subject. 

If you need to correct or alter 
entries after you have entered them, you 
can use the normal ‘navigation’ commands 
(‘first, ‘next’, ‘find’, etc.) to get at the 
record, and use the ‘Alter’ command to 
make the changes. 

If you find a single line is too 
short to fit some entries on, the best solu- 
tion is to design your own input screen, 
using sedit. You can drag the dotted field 
area down to cover two lines, in the fields 
that require more space. You will then 
need to include appropriate ‘sload’ and 
‘screen’ commands to ensure your cus- 
tom screen is available. 


Selection 


When you come to make a print- 
out, you need to decide whether you want 
all of the entries, or just some of them. If 
the former, you should first enter the in- 
struction: 


IncludeAll 


which will mark all the records as being 
required. If not, you should enter: 


Identify 


This steps through all the records in turn, 

asking if they are to be included. An an- 

swer of ‘Y’ will set the field ‘UseThis’ to 1, 

whereas ‘N’ will set it to 0. Only those set 

to 1 will be included in the printed list. 
The printing instruction itself is 
the command: 


PrintListYou 


are given the option of sending the output 


PALTER/INSERT 


we 


re 
Logical name 
Authort 
Titled 
Year 
Publisher$ 
Citys 
Compilationt 
Editors 
Journal 


1956 
Chicage 


Thomas, WL, 


to the screen (by entering an ‘S’); to the 
printer (by entering ‘P’); orto an exportfile, 
for which you should supply a filename. 
Such a file could be imported into Quill or 
another word processor for further editing. 
The various margins and underline codes 
are all set differently for each of these 
three output options. To change them you 
simply edit the procedure ‘OutputTo’ be- 
fore calling PrintList. 

The program will underline the 
publication title, which will be different for 
each of the three publication types. By 
sending CHR(16), the printer driver un- 
derline instruction is toggled on and off - 
whereas on the screen, CHR(5) does the 
same job. 


Hand-painted 


Unfortunately, Quill does not 
seem to import the underlining instruc- 
tions, so you would have to go through 
and ‘paint’ them in by hand. If anyone has 
found a way round this, Open Channel 
would just love to hear from you. 

Finally it may be useful to look 
briefly at the text formatting procedure 
‘Printline’ shown in the listings. It is a 
recurrent problem when printing from Ar- 
chive, that lines may need wrapping 
around, or otherwise chopping up over 
several lines. The procedures OutputTo, 
Printlnit, and PrintLine are all required 
for this, and could be used in any Archive 
application. 

PrintLine uses global variables 
to keep track of required margins, and 
current position on the line. This means 
you can keep sending as many pieces of 
text to PrintLine as you like, and it will 
continue adding to the line it started previ- 
ously, and wrap around correctly at the 
end of the line. It will only start a new 
paragraph when you re-initialise the posi- 
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fan's Role in changing the face of the earth 


tion variables, and Iprint one or more 
blank lines. 


Apologies 


As | said earlier, it is a tortuous 
and more-or-less unreadable bit of pro- 
gramming, for which | apologise. Its con- 
volutions are due to the number of excep- 
tions it has to catch. The best that can be 
said about it is that it works, which ulti- 
mately is what matters. 

The way to use it is as follows. 
Before printing can commence you should 
call OutputTo, to set the margin and un- 
derline variables. This will also redirect 
output to the chosen device. Before each 
paragraph you should call Printlnit, to 
initialise the current margins and position. 
From then on, you can keep calling 
PrintLine with as many text items as you 
require. After the first wrap-around the 
‘WrapMargin’ value will be used for the left 
hand side. If you set the variable ‘Under- 
lining’ to 1, text will be underlined until the 
end of the paragraph, or until you reset it 
to 0. 

At the end of the paragraph, you 
must, in addition to calling Printinit, send 
at least one Iprint, to move on to the next 
line. If you want a gap between para- 
graphs, further lprints are necessary. 

By allowing any number of sepa- 
rate PrintLine calls within a paragraph, 
there is no limit on paragraph size. If you 
gather all the text into one variable before 
formatting it, you are stuck with Archive’s 
255-character limit. The approach used 
here makes amore complicated program, 
butallows for much more flexible database 
presentation. 

If you have any Archive problems 
you would like to see solved on these 
pages, please write and tell me about 
them, care of Sinclair QL World. 
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o far in this series, | have only 
considered the subject of 
machine code programming 
in terms of writing complete 
multi-tasking programs, en 
tirely in machine code. All the 

examples given have been of this type. 
There are many advantages to this type of 
programming. The code is about as fast 
and compact as you can make it, and the 
most flexible. If it is possible to do some- 
thing on your QL then it must be possible to 
do it with machine code. Most other pro- 
gramming languages will impose some 
constraints. Even if they theoretically allow 
something, often the practical limitations of 
speed and size of program make it unwork- 
able. 

The big disadvantage is that the assem- 
bler language we use to produce machine 
code is by no means easy. This whole 
series has been about trying to make it 
easier, and | hope | have shown that with a 
bit of effort it is possible to put together 
useful programs without getting completely 
bogged down in the minute details of the 
language, provided we start from chunks 
of code which do recognisable jobs, rather 
than the single program lines which make 
up the language. But even doing things this 
way, it is still a very daunting prospect to 
write a major program entirely in machine 
code. 


Own library 


| have quite a library of small machine 
code programs | have produced for my 
own use. Some are very useful; others are 
interesting rather than useful. Most are 
what | would describe as experimental, in 
other words, just trying out ideas. But | 
have to confess that | have never produced 
a large program entirely in machine code, 
and perhaps | never shall. 
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In the last in the current series, Alan Bridewell explains 
how to combine machine code routines with SuperBasic 
programming for greater efficiency 


Whenever | try a major project, | fall back 
to one of the high-level languages, usually 
either Forth, or SuperBasic, which | then 
compile. The reason is simple enough. 
These languages are so much easier to 
follow and program. This, of course, is the 
reason they were invented. 

You may be getting the impression that 
| am trying to tell you that when it comes to 
major projects, machine code is alright for 
the whiz-kids writing for the leading soft- 
ware houses, but not for mere mortals. 
Well, that’s not what | am saying. For a 
start, if you have a talent for programming 
(and you’re twenty years younger than 
me!) then you ought to have a go. You 
never know what you can do until you try. 


The message 


However, the real message is this: you 
do not have to write complete programs in 
machine code. You can write short rou- 
tines which can then be incorporated into 
larger programs written in other languages. 
This can make the program faster and 
more concise than if it had been written 
entirely in a high level language. Itcan also 
make the language more flexible, and en- 
able you to do things you may not have 
been able to do if you had stuck purely to 
the high level language. 

For most people, the only high level 
language they will be familiar with on the 
QL is SuperBasic. So for the rest of this 
article | shall confine myself to using ma- 
chine code with SuperBasic. There are two 
ways of incorporating your machine code 
into SuperBasic. 

A machine code routine may be loaded 
into the QLram by first allocating some ram 
space for it using the Respr function, and 
then loading it into the space using the 
Lbytes command. For example, suppose 
you wished to load a routine called Fred 
from a disk in flp1_, and suppose “FRED is 


500 bytes long. Then we could start our 
SuperBasic program with the line: 


z= RESPR(500): LBYTES flp1_FRED,z 


and the routine would load into ram, 
starting at address z. If at some later part of 
the program, we use the line 


CALL z 


the program will start to execute the 
machine code routine from z. When the 
machine code has completed, it will return 
to the next line in the SuperBasic program, 
as long as the machine code ends with the 
two lines: 


MOVEQ #0,D0 ; RETURN NO ERROR 
CODE 
; RETURN FROM SUBROU 


Without the first of these lines, the ma- 
chine code will return with an error message 
and stop the SuperBasic program. Without 
the last one the routine will not return to 
SuperBasic, and the QL will probably crash! 

There is a further important feature of the 
Call command in SuperBasic. It can take 
up to 13 additional parameters, which will 
load in order into the data registers D1 to 
D7, and then the address registers AO to 
A5 before executing the machine code. 
This means that the same machine code 
routine can be made to do different jobs in 
different parts of the SuperBasic program, 
by starting with different parameters. This 
can clearly lead to a great deal of flexibility 
in use. 

There is, as always, a down side to all 
this. Up to this point in the series, | have 
paid little attention to error trapping. Error 
trapping means that if some data goes into 
the program so that it cannot execute 
properly, it does not crash, but comes up 


with an error message, and still leaves us 
(or the program) in control. The reason | 
have been able to ignore it is because if 
all the data comes from within the code, 
there should be no errors unless there is 
a mistake in the code. The only occasion 
in the series where this was not the case 
was the file transfer routine in part 2. In 
that program, the user had to key in de- 
vice names for input and output channels. 
Without error trapping, any typing errors 
there would have crashed the program. 


Outside errors 


Clearly, if the SuperBasic program 
can change parameters used by our 
machine code, there is room for errors 
to arise from outside the machine code. 
So we must carefully trap them to make 
sure they do not crash the QL. In most 
cases, this is a very simple process. 
The majority of Qdos trap calls and 
vectored routines leave a zero in 
register DO if there is no error, and 
leaves a negative number if there is 
an error. The value of the negative 
number indicates the type of error. So 
after the call is completed we use the 
lines:- 


TST.LDO ;ISDO ZERO? 

BNE ERR_Close ; IF NEGATIVE, 
BRANCH TO 

; Close WITH ERROR CODE 


If there is no error, the second line is 
ignored. Butif there is an error, the second 
line will branch to the short routine to leave 
the machine code with an error message 


.ERR_Close MOVE.W #$CA,A2 ; 
UT_ERRO in A2 
JSR (A2) 


This causes an error message to print in 
channel 0, depending on the number in DO. 

If you have some other code (not a Qdos 
call) which might get an error, you will have 
to devise your own test for the error (usu- 
ally by comparing some data with result 
obtained), then if an error is detected, put 
a suitable negative number in DO before 
branching to ERR_Close. This canbe tricky, 
and there are no general rules for it. A 
simple example of this appears in one of 
the listings. 

The other way of incorporating your 
machine code into a SuperBasic program 
is to make the machine code routine a 
SuperBasic procedure or function. This 
means that when you Lbytes and Call the 
routine (with no extra parameters) the 
routine has a name which is added to the 
list of SuperBasic words. The machine 
code needs to calla short routine to add the 
procedure or function name to the 
SuperBasic list, and also to point to the 
code to be used when the name is used in 
SuperBasic. 


MACHINE CODE 


Listing 1 


ERERREEREEEKEEREE EEE EE EE EER EEL EEE ERIE EEE LIEK EERE KEE REESE IKE HEH IMEI 
“CALLCHANNEL ID‘ 

EREEEEEREEERERE EEE EERE EEE LEER EEER IEE KEE REE ERIE LEHR EEE IEEE EINEM EAA EEN 
THIS ROUTINE WILL TAKE THE FIRST PARAMETER OF THE CALL, WHICH GOES INTO 
REGISTER Di, AND CONVERTS IT TO A BASIC CHANNEL ID IN 40. 
IT SHOULD BE THE FIRST PART OF THE CALL CODE. 
AS IT IS THE START OF A ROUTINE WHICH WILL CORRUPT REGISTERS, THE FIRST 
LINE IS TO STORE REGISTERS. THESE REGISTERS SHOULD BE RESTORED BEFORE 

5 RETURNING TO BASIC. 


» START MOVEM.L AO-A7/D1i-D7,—-{A7) 5; STORE REGISTERS 
MOVEQ #$28,D0 3 #CH_LENCH IN DO 
MULU DiI ,DO 3 MULTIPLY CH. NO. BY ENTRY LENGTH 
MOVE.L $30(AG),A2 3; BV_CHBAS IN AZ 
ADDA.L DO,A2 3 ADD TO GET CHANNEL ID ADDRESS 
MOVE.L O(A6,42.L),A80 3 CHANNEL ID IN AO 


EEEKEEEEE EEE EEE EEE EEE REEL E LER EEE EER EL ER ER EEE KEELE EEE EER ERIE EEKE EER EI AIRE 
Listing 2 


ERREEEEEEREER ERE EEE EEE EERE ELLE KLEE ELLE LESLIE IIE IAS INIA IA IANA IIIA 
“DEFPROC’ 
EERE REEER EKER EEE EEE LEER EE ERE REEL LES ER ENE AIEEE IKE EISEN IKI ISELIN 
THIS ROUTINE WILL ADD @ LIST GF PROCEDURES AND FUNCTIONS TO THE 
SUPERBASIC LIST 
MOVE. W #110,A2 5 BP_INIT IN A2 
LEA PROC_DEF,A1 ; BASIC PROCEDURE DEFINITIONS 
oMP (A2) : 


NEXT IS THE PROCEDURE & FUNCTION DEFINITION TABLE. ADJUST TO SUIT. 
THE FIRST WORD SHOULD BE THE NUMBER OF PROCEDURES. BUT IF THE NAMES ARE 
; LONGER THAN 7 BYTES, IT WILL NEED MORE. 
-PROC_DEF DC.W 2 3 ONE LONG NAME PROCEDURE 
5 THIS IS FOLLWED BY THE NEXT THREE LINES REPEATED FOR EACH PROCEDURE 
DC.W START-* 3 POINTER TO ROUTINE 
DC.B 8 3 LENGTH OF NAME 
DC.B "ELLIPSES’ 3 PROCEDURE NAME 
THEN 4 © TO INDICATE THE END OF THE PROCEDURES 
DC.W o 5 END OF PROCEDURES 
THIS IS FOLLOWED BY EXACTLY THE SAME PATTERN FOR FUNCTIONS 
DC.W 9 3 NO FUNCTIONS 
DC.W 0 s END OF DEFINITIONS 


3 
3 RERERERERERER EEE RE REE KER ELE EE KER IEEE EEE IEEE INANE IAESEN EN IIIEIAAIIIA 


Listing 3 


EERE RERERE EERE RE EEK ER EE EERE LEE ERE EEE EEL KEEEE EEE EEE EEA IRIAS SAN 
“PROCCHANNEL ID‘ 

EEREEEREEEEEERE REE EE EERE EERE LER EEE RE EERE ELIE EERIE EES IIIA IA IEA IM 

THIS ROUTINE WILL TAKE THE ONE PARAMETER OF & PROCEDURE AND TURN IT 

INTQ A BASIC CHANNEL ID IN AO 

TT SHOULD COME AT THE START OF THE PROCEDURE, AFTER STORING REGISTERS. 


MOVE. W #118,A2  ; CA_GTLIN IN AZ 

JSR (A2) 

MOVEQ #-15,D0  ; ERR_BP IN DO 

CMPI.W #1,D3 ; ONE PARAMETER ? 

BNE ERR_CLOSE ; IF NOT, CLOSE 

MOVE. L 0{A&,A1.L),DO ; PARAMETER IN DO 

MOVEG #$28,D1 3 CH_LENCH IN Di 

MULU D1,DO 

MOVE. L #30(AG),AZ ; BV_CHBAS IN AZ 

ADDA.L DO, AZ 

MOVE. L O{A6,A2.L),AO ; CHANNNEL ID IN AO 
3 
H ERERERER EKER EEE RE ER EEE LIER ER ERIE REE ELLIE ELIE EIS EA IIIB AIAA Hee ee 


Listing 4 


5 EREEREE EE ERE EERE ER EE EEE ERE EEE ELER ERE ER ES IEKL ER ERE ESLER ERE ER EM 
; ‘ERR_CLOSE‘ 

H EERE EREEE EERE EEL EE EEE ERERELE EE LE EERE EERE EEE EEE RENAE EEL EEE ENE IAEA AREAS 
; WHEN AN ERROR HAS BEEN DETECTED, AND THE ERROR CODE IS IN DO, A BRANCH 
} TO THIS CODE WILL PRINT AN ERROR MESSAGE IN BASIC CHANNEL #0 

3 THIS CODE SHOULD BE FOLLOWED BY WHATEVER CODE IS NEEDED TO MAKE 4 SAFE 
; RETURN TO BASIC. 

3 


ERR_CLOSE MOVE. W #CA,A2 3 UT_ERRO IN A2 
JSR {A2) 


3 
Hy EREEEKE LEE EE EEREEEERE EERE EEE EE EE EERE REE EERIE EEA EK EER AI IAI ESHER RAR 


Listing 5 


§ ERR ER EERE RRR EEE EEE REE ER EEE ERE EER ERE ERE RE ERE EE EE EEE EEE EEHKER EEE REE EE 
3 ‘ ELLIPSES CALL CODE‘ 

FREER E EERE KEKE REE EE EEE EEE EERE EEE EEE REEL ERE KEELE EEE RINE EAK AEA 
: “CALLCHANNEL ID * 

: 

. 


START MOVEM.L A0-A7/D1-D7,-(A7) ; STORE REGISTERS 
MOVEG #$28,D0 3 #CH_LENCH IN DO 
MULU - Di,DO 3 MULTIPLY CH. NO. BY ENTRY LENGTH 
MOVE.L $350(A6),A2 3 BYV_CHBAS IN AZ 
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Adding routines 


More aboutthis later. This is what Toolkits 
usually do, and Simon Goodwin’s excel- 
lent DIY Toolkit series shows lots of exam- 
ples of this approach to adding machine 
code routines to SuperBasic. | have no 
wish to duplicate his efforts, and | suggest 
you refer to his articles to discover more. | 
would simply add the point that you do not 
have to stick to Toolkit routines, that is, 
ones that might have a variety of uses in 
different programs. You can use the same 
technique for machine code written specifi- 
cally to go into one particular program for 
one particular purpose. 

To illustrate how all this works, | am 
going to use the Ellipse program put to- 
gether in part 8 of this series. | think it will 
be informative to see the same basic rou- 
tine as both a free standing program, and 
as part of a larger program. There are a 
number of modifications that need to be 
made, both to make it work as a subrou- 
tine, and to make it more flexible. 

1. Since it is not to be a free standing 
program, it does not need Jobstart or 
Endjob, so these are removed. However, 
the routine will need to end with the two 
lines mentioned earlier, so that it returns to 
SuperBasic successfully. 

2. As part of a SuperBasic program, it 
would be better to use SuperBasic console 
channels, and enter the channel number 
as a CALL parameter (or as a procedure 
parameter, if you have done it that way). 
This means it does not need Console and 
Close to open andclose aconsole window, 
so these are removed. There is also no 
need to activate a cursor inthe SuperBasic 
console windows, so we remove Cursor. 

3. As we are not going to close the 
console window, we need to restore ittoa 
normal print mode from the XOR mode 
used in the Ellipse routine, so we need to 
add a Writemode at the end of the routine 
to restore the normal print ink colour onto 
paper colour mode. 


Error trapping 


4. We need to include some appropriate 
errortrapping. Inthis case, the main source 
of any error will be the channel number 
entered as a parameter. The number used 
has to be that of a channel which has been 
opened, obviously. Also, the Fbyte sub- 
routine requires this to be acon_ channel. 
In the case of the code being used as a 
SuperBasic procedure, we mustalso check 
that only one parameter is used. (Actually, 
we could ignore the extra parameters if 
more than one is entered, but it is good 
form to check anyway.) 

5. We need some code to turn our pa- 
rameter into the channel ID needed in 
register AO. Also, in the case of the 
SuperBasic procedure, we need some 
code to get the parameter from the 
SuperBasic in the first place. Since these 
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two points are the biggest innovations in 
this article, we shall look at them in some 
detail. 

The first important point to remember is 
that just about everything the QL stores 
aboutits SuperBasicis in an address which 
is stored relative to the address in register 
A6. This is done so that as the demand for 
ram space changes, Qdos can simply move 
the whole lot to a new set of locations, but 
only has to change the address in A6 to 
enable us to work out the new position of 
everything else. The SuperBasic channel 
IDs are stored in addresses starting from 
$30 above A6. So we can get the address 
into register A2 with the command: 


ADDA.L 
MOVE.L 


DO,AZ 
0(A6, AZ. 


MACHINE CODE 


MOVE.L #$30(A6),A2 


Each channel entry is $28 bytes long, 
and they run in sequence from channel #0 
upwards. So if we multiply our channel 
number by $28, and add that to the ad- 
dress we have put in A2, we get the ad- 
dress of the channel entry for the channel 
we want (relative to A6, of course!) The 
long word at this address is the channel ID. 
Sowe can putthe channel |Din register AO, 
where it is needed for our routines, using 
the line 


MOVE.L 0(A6,A2.L),A0 


3 ADD TO GET CHANNEL ID ADDRESS 
L),AO ; CHANNEL ID IN AO 


EEKEKEREKER EEE EEE KEELE EL EL ERE EEE EER EE EERE EEE ER ERE ELE LE EEEE EEE EL EEER EE 
; THE REST OF THIS IS COMMON TO BOTH THIS PROGRAM AND THE CODE NEEDED 
TO MAKE ‘ELLIPSES’ A SUPERBASIC PROCEDURE 


WMODE MOVE® 
MOVE. W 


TRAP 


#$2C,D0 
43 


LEA.L 
LEA.L 
MOVE® 
MOVE.L 
DBRA 
BRA.S 


EXA,A2 
#4,D1 


D1, LOOP 
FIRST 


JSR FRYTE 
3 AN INVALID CHANNEL ID WILL GENERATE 


#$FFFF,D1 


{@l)+, (AZ) 


3 #SETMD IN DO 
3; XOR INK INTO BACKGROUND 
3 


DEFAULTS,A1 3 DEFAULT PARAMS ADDRESS IN Ai 


ACTUAL PARAMS ADDRESS IN 42 
LOOP COUNTER 

3 MOVE TWO PARAMETERS 
DECREMENT AND LOOP 

DRAW DEFAULT ELLIPSE 


; GET KEY PRESS 
AN ERROR HERE TO BE TRAPPED 


3} ---- ADD NEXT TWO LINES TO TRAP ERRORS -—-—— 


TST.L 
BNE 
LEA.L 
CMPI.B 
BEG 
LEA.L 
CMPI.5 
BEa.S 
JSR 


DO 


BYTE,AL 
#10, (Al) 
CLOSE 
BYTE,AL 
#32, (A1) 
coPyY 
ELLIPSE 
JSR TEST 
«FIRST JSR ELLIPSE 
3; AN INVALID CHANNEL ID WILL GENERATE 


; ERROR ? 


ERR_CLOSE 


BYTE ADDRESS 
IS BYTE = 10 
IF SO, CLOSE 

; BYTE ADDRESS IN Al 

IS BYTE = 32 <SPACE> 
IF 80, NEW ANOTHER ELLIPSE 
TO REMOVE OLD ELLIPSE 
TEST FOR KEY PRESS 
TO DRAW NEW ELLIPSE 

AN ERROR HERE TO BE TRAPPED 


IN Al 
<ENTER>? 


3 ---- ADD NEXT TWO LINES TO TRAPP ERROR ---— 


TST.L 
BNE 
BRA 


DO 


MAIN 


LEA.L 
MOVEO 
MOVE. W 
MOVE. W 
TRAP 
MOVE.B 
RTS 


BYTE,AL 
#1,D0 
#0,D4 


3 
«BYTE DC.B f9] 


---- DELETE LINE TO SET ADDRESS OF RI 


~ ELLIPSE 


MAKE ROOM FOR 1ST INTEGER 
SUBO.L #2,A1 
PUT FIRST INTEGER ON RI STACK 


MOVE. W 
CONVERT TO F.P. 
MOVEO 
MOVE .W 
JSR 
REPEAT FOR 2ND INTEGER 
SUBQ.L 
MOVE. W 
MOVEG 
JSR 
NOW DIVIDE ONE F.FP. 
MOVEQ 
JSR 


#5,D0 
$110,A3 
(83) 


#2,A1 


#8,D0 
(A3) 


#10,D0 
(AZ) 


#$FFFF D3 


3 ERROR? 


ERR_CLOSE 


3 AND START AGAIN 
BYTE STORE ADDRESS IN Ai 
IG_FBYTE IN DO 
CLEAR WORD IN Di 
INFINITE TIMEOUT 


STORE BYTE 


5 
STACK ---- 


EXA,0(A4,A1.L) ; 


: #RI_FLOAT GN DO 
; RI_EXEC ON AS 
5 


3 


EXB,O(A6,AL.L) 5 


NUMBER BY THE OTHER TO LEAVE X COORD ON RI 


3 #RI_DIV ON DO 


3 


NOW REPEAT THE WHOLE THING FOR THE Y COORDINATE 


MAKE ROOM FOR 1ST INTEGER 
SUBO.L #2,01 
PUT FIRST INTEGER ON RI STACK 
MOVE. wW 
CONVERT TO F.P. 


EYA,O(A6,A1.L) ; 


45 


MACHINE CODE 


If this all sounds too much to handle, ly te biti a 
. . 3 . 8 
don’t worry. Listing two is a short routine REPEAT FOR 2ND INTEGER 
to do this for you. If you Call your routine boeieeione Le acd eee 
from SuperBasic with the channel number MOVED galing > 
as the one parameter after the address, JSR (AS) 3 
A H ‘ NOW DIVIDE ONE F.P. NUMBER BY THE OTHER TO LEAVE Y COORD ON RI STACK. 
this routine at the Start of your code will HOVEG #$10,D0; #RI_DIV ON DO 
put the channel ID in AO for you. The only JSR (AS) ; 


part of this not already mentioned is the NOW REPEAT THE WHOLE THING FOR THE ECCENTRICITY 
first line. Since your routine will alter the MAKE ROOM FOR 1ST INTEGER 


registers, they must first be saved on the SUBO.L #2,A1 ; 
stack (except DO, of course). Clearly, at AE pie a uid aie ators eg liar 
MOVE.W ECCA,O(AG,AL.L) 3; 
the end of your routine, you must restore CONVERT TO F.P. 
the registers before returning to er ann 
SuperBasic. REPEAT FOR 2ND INTEGER 
SUBRB.L #2,A1 Hy 
i MOVE. W ECCB,O(A6,AL.L) ; 
To SuperBasic a ee 3 
JSR {AS) 3 
Listing 2 is how you add your routine 3 NOW DIVIDE ONE F.P. NUMBER BY THE OTHER TO LEAVE ECCEN. ON RI STACK. 
to the SuperBasic list of procedures and eg Tad) Cee Nl Be Een BS 
. . a 
functions. It follows a very simple format, 


j NOW REPEAT THE WHOLE THING FOR THE RADIUS 
which should Gaus] ge problems, = 3 MAKE ROOM FOR 1ST INTEGER 
you have tried it a few times. It starts with SUBG.L #2, Ai ; 


the routine itself, which is to load the 3 PUT FIRST INTEGER as BORE : 
address of the vectored routine BP_INIT conte Fue Eon 10{AG,AI.L) 5 
into A2. The address of the definitions "Moves : 
table is loaded into A1, and then there is JSR 3 


é . REPEAT FOR 2ND INTEGER 
a jump to the vectored routine. SUBO.L 


The definition table itself follows a fixed MOVE. W RADB,O(AS,AL.L) ; 


7 MOVEG #8,D0 1 
format, as follows: JSR (a3) ; 


We start with a word for the number of NOW DIVIDE ONE F.P. NUMBER BY THE OTHER TO LEAVE RADIUS ON RI STACK. 
procedures to be added. This word allo- NGVER wStO,;DO  f BRI_DIV SONIDO 
cates space in the procedures table, but bie rT ‘ 
if the average name length is more than NOW REPEAT THE WHOLE THING FOR THE ANGLE OF ROTATION 
seven, then more space is needed. With MAKE ROOM FOR 1ST INTEGER 
one eight-character name, | have made PUT FIRST INTEGER Sa hi svace T : 
this word equal to 2. Then for each pro- MOVE. W ROTA, O(AG,AL.L) 5 


cedure to be added, this word is followed SENET OOF: Ps 


#RI_FLOAT ON DO 


#RI_FLOAT ON DO 


3 MOVEQ #8,D0 3 #RI_FLOAT ON DO 
by a word for the address of the routine, JSR (a3) : 


a byte for the length of the procedure REPEAT FOR 2ND wi — 
name, and a byte string for the name MOVE_W ROTB,O(AS,AL-L) 3 


itself. A zero word then indicates the end MOVED #8,D0 3 


JSR {AS) 
of the procedures. Exactly the same NOW DIVIDE ONE F.P. NUMBER BY THE OTHER TG LEAVE ROTATION ON RI STACK. 
pattern follows for the functions. In our MOVEG #$10,D0 #RI_DIV ON DO 
case, we have no functions to add, so we JSR (AS) 
have a zero word for the number of NOW ELeT OTHE UTP 
functions and a zero word for the end of MOVEG #$33,,D0 #SD.ELIPS ON DO 
the functions. This pattern is very simple a get NES En BU STAG TABEGCUTE 
to modify to add any number of proce- RTS 


dures and functions to SuperBasic. 3 
} INTEGER TABLE 


-EXA DC.W 80 
Channel ID -EXB DC.W 1 
.EYA DC.W 50 


sat . fF »EYB DcC.W i 
Listing three is the routine to convert .ECCA DC. W 10 


the SuperBasic channel number, passed -ECCB DC.W 10 
with the procedure, into a channel ID in iene: cba : 
AO. It starts with a jump to the vectored [ROTA DC.W 31 
routine CA_GTLIN, which will fetch an EROTeE Dee W ae 
indeterminate number of long word argu- DEFAULTS 
ments passed when a procedure is called DC. W 80 
from SuperBasic. These long words are pi 5 
stacked up on the arithmetic stack, and DC.W 4 
the number of long words passed is re- DC.W 10 
turned as the word in D3. eee 2 

At this point we put in our DIY error DC.W 1 
trapping for the number of parameters. ape a 
We put -15 in DO, and if it is still there 
when we return from the procedure, it will LEA.L BYTE, Al 
generate a bad parameter message in —o ray si 
channel 0, and cause the SuperBasic LEA.L BYTE, AL 
program to stop. We then compare D3 eM TSB Hats nt) 


with 1, and if it is not 1 we branch to the 


iST INTEGER OF CENTRE X 

2ND INTEGER OF CENTRE X 

iST INTEGER OF CENTRE Y 

2ND INTEGER GF CENTRE Y 

1ST INTEGER OF ECCENTRICITY 
2ND INTEGER OF ECCENTRICITY 
1ST INTEGER OF RADIUS 

2ND INTEGER OF RADIUS 

1ST INTEGER OF ROTATION 
2ND INTEGER ROTATION 


we we san we san 


iST INTEGER CENTRE X 

2ND INTEGER CENTRE X 

IST INTEGER CENTRE Y 
2ND INTEGER CENTRE Y 

iST INTEGER ECCENTRICITY 
2ND INTEGER ECCENTRICITY 
1ST INTEGER RADIUS 

2ND INTEGER RADIUS 

iST INTEGER ROTATION 
2ND INTEGER ROTATION 


we an we ae ee we we ae ae 


BYTE ADDRESS IN Ai 
IS BYTE = <CTRL><UP> ? 
IF 80, THEN UP 

BYTE ADDRESS IN Al 

IS BYTE = <CTRL><DOWN> 7 
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MACHINE CODE 


ERR_Close routine, which means the 

program will stop with an error message. BEQ.S DOWNFP 
lf there is no error, we move the param- ae lie i 
eter to DO. Remember that A1 points to LEA.L RADA, Ai 
the stack, relative to A6, so to do this we ale RADB hz 


: MOVE. W (Ai) ,DO 
need the line CMPI.W #100,D0 


BEQ NEXTBIT 

ADDI.W #1, (AL) 

MOVE.L 0(A6,A1.l),D0 MOVE. Wi (AL) ,DO 
CMPI.W #100,D0 


IF SO THEN DOWN 
IF NEITHER, SKIP TO NEXT BIT 


RADA ADDRESS IN Al 
RADB ADDRESS IN AZ 
RADA IN DO 

RADA ALREADY 100 ? 

IF SO LEAVE UNCHANGED 
ADD 1 TO RADA 

RADA TO DO 

IS RADA =100 ? 


‘a0 ne ae a ee as aa 


The rest of this is to turn the parameter Listing 6 


into a channel ID, and is the same as SKE ER EKER KEKE KEKE EEE EEE E EEE EE EEE EERE REEL EEE EEE ELE EEL EEL ERE 


Listing one. ‘ELLIPSES PROCEDURE CODE’ 
teat . . H KEK EKER KER EEE REE EEE EER ER EERELEERE EEE ERE EEE LEER EEE REE EEEEEEECEEEEERE 
peyton A THIS CODE MUST BE PLACED IN FRONT OF THE COMMON CODE FROM LISTING 5 


: ‘ : TO MAKE THE NAME ‘ELLIPSES’ INTO A SUPERBASIC PROCEDURE 
error is detected, and if there is an error code basse eB ne A cdnclbont ea 
in DO, itwill printthe errormessage in channel LEA PROCDEF,Ai ; BASIC PROCEDURE DEFINITIONS 
0. This code should be followed by whatever oMP (AZ) 3 
isn k ic. 3 
ear easaferetumtoSuperBasic *PROC_DEF Dc.W 2 3 ONE LONG NAME PROCEDURE 
is normally means retuming registers to DC. W START-* 3 POINTER TO ROUTINE 
their previous state, and possibly also making oes Artal ; eee Onna 
‘ . ‘ DC. EK * 3 PROCE Nél 
sure the write mode for any windows is back nota SEND GE PROCEDURES 


to normal. DC.W NO FUNCTIONS 
Dc. wW ; END OF DEFINITIONS 


‘as an we ae ew 


Application Rueae 


; ---- ADD NEXT LINE TO STORE REGISTERS —--- 


i . MOVEM.L D1-D7/A0-A7,-(A7) 3 STORE REGISTERS 
We are now going to apply all this to Se $118,A2  ; CA GTLIN IN AZ 


making our Ellipses program into a rou- JSR (Az) 

tine to use in a SuperBasic program, first ene agin ag 3 a apie ta sf 

as a piece of Call code, and then as a BNE ERR CLOSE ; IF NOT, CLOSE 
SuperBasic procedure. In both cases, the MOVE. L 0(A6,A1.L),DO ; PARAMETER IN DO 


j ict] i MOVEG #$28,D1i 3 CH_LENCH IN Di 
major part of the listing will be the same. aa mt De 3 


Only the front end of the code will be MOVE. L $30(AS),A2 ; BV_CHBAS IN AZ 

different in the two cases. In order not to ADDA.L DO,A2 

repeat large amounts of listing, | have put sidaicackan O6A6 AEN BO CINE cP aAn OP 

in the complete listing for the Call routine KEKE KEE KEKE EEE K KEKE LE EE EE EEE EEE REL ELE EEE ELE EERE IR ER EE ELEREEEREEEEEEERE 
as Listing five , and the modification 

needed to make Ellipse a SuperBasic Urs aeoait ices gaa loch 
procedure as Listing six. If you have been BRA NEXTBIT SKIP DOWN 


following this series and have already BUGMNS Eeaiee Oba Chg) i ggg es 
- : . (Al) SUBTRAI 1 FR TEGER 
typed in the program in part8, youcan use BRA NEXTBIT 


thatas astarter for Listing five, and make 


5 
: F : . UPDOWN4 LEA.L BYTE, AL BYTE ADDRESS IN A 
the appropriate alterations. The following CMPI.B #211, (Ai) 3 IS BYTE PP aLT cern oeues 2 


assumes that is what you will be doing. BEQ.S UP4 IF SO, THEN UP 
Daltile 3 legible ted ok CMPIGB #219, (A1) 3 TS BYTE. = <ALT><CTRL><DOWND 7 
: = > 7 
and anything before that can be deleted. BEQ.S DOWN4 IF 80, THEN DOWN 
In the .MAIN routine, Fbyte will generate BRA NEXTBIT IF NEITHER, SKIP TO NEXT BIT 


j i if j ~UP4 LEA.L ROTA,AL INTEGER ADDRESS IN Al 
an error if the channel is not open, or if it ASNT. Ww #1, (AL) pant tae career 


is not a con_ channel, so this error must BRA NEXTBIT SKIP DOWN 
be trapped. Similarly, Ellipse may generate . DOWN4 LEA.L ROTA,AL INTEGER ADDRESS IN Al 
an error to be trapped. Right at the end of SUBI.W #1, (Al) SUBTRACT 1 FROM INTEGER 
the code we must add the ERR_Close NEXTBIT RTS 
pOuUNG XO PRGr ety ein messede ier ; ---- ADD THE FOLLOWING LINES TO CLOSE ROUTINE AND RETURN TG BASIC ——-—- 
trapped errors, and .Close will restore the “ERR_CLOSE MOVE. W $CA,A2 } UT_ERRO IN A2 
window used to normal print mode, and JSR Gel aes Ane 
H i »~CLOSE MOVEG #£ DO H ETM oO 

restore the registers. At the front of all this MOVE.W «#0, D1 } NORMAL PRINT MODE 
is merged Listing 1, which will store the TRAP #3 3 
registers, and turn the parameter of the MOVEM.L {@7)+,D1-D7/AO-A7 ; RESTORE REGISTERS 

. ar RTS 3 
Call into a channel ID. And that’s it. 

To make Ellipse a SuperBasic proce- EERE RIKI III ISAIAH A EAE I ANI AIA AHA AIAN AI AA INAS AA IAAL A LAIMA 

dure, we simply merge Listing six at the BNE NEXTBIT IF NOT, NEXT BIT 
front instead of Listing one. This is es- MOVE.W (A2) ,DO RADB TO DO 

é : 5 a ae CMPI.W #1,D0 IS RADB = 1 ? 
sentially a combination of Listings two BEQ NEXTBIT THEN LEAVE RADA,RADB UNCHANGED 
and three to add Ellipses to the procedure MOVE. W #10, (A1) ELSE, RADA = 10 
list, and to turn the procedure argument Sa a ol Sc ee 
into a channel ID. One extra line is added DIVU D1i,DO RADB/ 10 
to store the registers. This is to balance MOVE. W DO, (A2) NEW DO VALUE IN RADB 

F : BRA NEXTBIT SKIP TO NEXT BIT 

the restore registers line at the end of ; MAKE NUMBER SMALLER. 
Listing five. As | am not too familiar with . DOWNFP LEA.L RADA, Ai RADA ADDRESS IN Ai 
the inner workings of SuperBasic, | am He a MSs en —— IN AZ 
not sure this storing and restoring regis- CMPI.W  #9,D0 BADR ALREADY On"? 
ters is actually needed here, because | BEQ NEXTBIT IF SO, LEAVE UNCHANGED 


suspect that SuperBasic deals with this SUBDEW eis thy SUBTRACT 1 FROM RADA 
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already. However, it certainly wont do any 
harm, and anyway, its a good policy to 
make sure that whenever you do anything 
which may corrupt the registers, you al- 
ways store them beforehand and then re- 
store them afterwards. 


Test program 


Listing seven is a short SuperBasic pro- 
gram to test the working of both the Call code 
and the Ellipses procedure. All it does is to 
open a random set of con_ channels number- 
ing 3 to 9, to add to the SuperBasic default 
channels 0, 1 and2. Itthen gives youthe choice 
of using either the Call code or the Ellipses 
procedure, followed by the choice of which 
channel to draw in. You can then draw circles 
and ellipses all over the screen to your hearts 
content, noticing thatboth methods workequally 
well. The SuperBasic itself is straightforward 
and needs no explanation to those of you 
familiar with the language. The only point that 
needs making is that as it stands the program 
expects to find the Call code as flp1_ELLCALL 
and the procedure code as flp1_ELLPROC. 
You may need to alter this to suit you device 
and file names. Also, | have made no attempt 
to Respr exactly the right amount of ram space 
- 1000 bytes is more than enough. 

Although we have only considered using 
machine code within SuperBasic programs, 
clearly, there is scope for using it with other 
languages. Often, languages like Forth and 
C arenotdesigned fora particular computer, 
and are therefore unable to take advantage 
of many of the special facilities a machine 
like the QL can offer. This can be overcome 
by using machine code routines. The docu- 
mentation with your language should tell 
you how to doit. However, a word of caution 
is needed. One of the big advantages of 
these languages is that the programs are 
portable, that is, a program written on one 
computer will run on a different computer. If 
you put QL specific machine code routines 
in, this will no longer be true. Your program 
willonly run ona QL orcompatible machine. 


Conclusion 


This is the end of the series for the present. 
Clearly my little Toolkit is not a complete list of 
allthe routines thatmightbe useful. Forexample, 
| have not touched the wide area of input and 
output to files in data bases, for the simple 
reason that the programming problems this 
throws up do not particularly interest me. But | 
hope it has managed to persuade some QL 
users, who at present only copy listings, that 
writing machine code is not as formidable as it 
at first seems. If you have followed this series 
through, you shouldbe able to putsome simple 
ideas into practice; in which case, please do 
havea go. Remember, new software is the life- 
blood ofa machine like the QL. Even ifyoucant 
producing something that can be sold com- 
mercially (lets face it- most of us can’t), youcan 
always see if QL World will print it, or perhaps 
Quanta or one of the PD libraries would like it. 
Happy coding! 
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. UPDOWN 


3 
- UPDOWN2 


»UP2 


- DOWN2 


5 
- UPDOWNS 


MACHINE CODE 


MOVE .W 
CMPI.W 
BNE 
MOVE.W 
CMPI.W 
BEG 
MOVE.W 
MOVE.W 
MOVE.W 
MULU 
MOVE. W 
BRA 


(AL) ,DO 
#9,D0 
NEXTBIT 
(A2) ,DO 
#10000 ,DO 
NEXTBIT 
#99, (A1) 
(A2) ,DO 
#10,D1i 
Di,DO 
DO, (AZ) 
NEXTBIT 
LEA.L BYTE, AL 
CMPI.B #208, (A1) 
BEQ.S uP 

LEA.L BYTE, AL 
CMPI.B #216, (AL) 
BEQ.S DOWN 

BRA UPDOWN2 
LEA.L EYA,AL 
ADDI.W #1, (AL) 
BRA NEXTBIT 
LEA-L EYA,AL 
SUBI.W #1, (A1) 
BRA NEXTBIT 


RADA TO DO 
IS RADA = 9 ? 
IF NOT, NEXT BIT 

3 RADB TO DO 
IS RADB = 10000 IF DIVIDING 
THEN LEAVE RADA,RADB UNCHANGED 
ELSE, RADA = 99 
RADB IN DO 
10 IN Di 
RADB*10 
NEW DO VALUE INTO RADB 


BYTE ADDRESS IN Ai 
Is BYTE = 208 7? 
IF SO, THEN UP 
BYTE ADDRESS IN Al 
IS BYTE = 216 ? 
IF SO THEN DOWN 
IF NEITHER, SKIP TO UPDOWN2 
INTEGER ADDRESS IN Al 
; ADD i TO INTEGER 
SKIP DOWN 
INTEGER ADDRESS IN At 
SUBTRACT 1 FROM INTEGER 


BYTE ADDRESS IN Ali 
IS BYTE = <RIGHT>? 
IF SOQ, THEN UP 
BYTE ADDRESS IN Al 
IS BYTE = <LEFT> ? 
IF SO THEN DOWN 
IF NEITHER, SKIP TO UPDOWNZ 
INTEGER ADDRESS IN Al 
ADD 1 TO INTEGER 
5 SKIP DOWN 
INTEGER ADDRESS IN Ai 
SUBTRACT 1 FROM INTEGER 


LEA.L 
CMPI.B 
BEa.S 
LEA.L 
CMPI.B 
BEQ.S 
BRA.S 
LEA.L 
ADDI.W 
BRA 
LEA.L 
SUBI.W 
BRA 


BYTE,AL 
#200, (A1) 
uP2 
BYTE,AL 
#192, (A1) 
DOWN2 
UPDOWNS 
EXA,Al 
#1, (AL) 
NEXTBIT 
EXA,AL 
#1, (AL) 
NEXTBIT 


BYTE ADDRESS IN Al 
IS BYTE = <ALT><UP> ? 

IF SO, THEN UP 

BYTE ADDRESS IN Ai 

IS BYTE = <ALT><DOWN> ? 

IF SO THEN DOWN 

IF NEITHER, SKIP TO UPDOWN4 


LEA.L 
CMPI.B 
BEQ.S 
LEA.L 
CMPI.B 
BEQ.S 
BRA.S 


BYTE,At 
#209, (AL) 
UPS 
BYTE,Ai 
#217, (01) 
DOWNS 
UPDOWN4 


Listing 7 


100 
110 
120 
130 
140 
150 
160 
170 
180 
190 
200 
210 
220 
230 
240 
250 
260 
270 
280 
290 
300 
310 


340 
350 
360 
370 
380 
390 
400 


init 

REPeat loop 

CLS#0 

PRINT#O,"SUPERBASIC PROCEDURE(P), CALL CODE(C) or QUIT(@) 7" 
as=INKEYS (-1) 

SELect ON a¢ 

= proc_code 

call_code 


= "q 
FOR chan = 3 TO 9: CLOSE#chan 

STOP 

END SELect 

END REPeat loop 

STOP 

DEFine PROCedure init 

MODE 0 

OPEN#3 ,con_5i2x256a0x0: CLS#3 

P = RESPR(1000) 

c¢ = RESPR(1000) 

LBYTES fipi_ellproc,p 

CALL p 

LBYTES fipi_ellcall,c 

FOR chan=3 TO 9 

x = RND(100 TO 512) 

y = RND(100 TO 200) 

xO = RND(O TO 5i2-x) 

yo = RND(O TO 200-y) 

OPEN#chan , “con_"&x&"x "ky" a" &xok"x "Ryo 
INK#chan,RND(2 TO 7):BORDER#chan,2,RND(2 TO 7) :OVER#chan,-1 
END FOR chan 

END DEFine 

DEFine PROCedure proc_code 

CLS#0: select_chan:prompts:ELLIPSES#ch 

END DEFine 

DEFine PROCedure call_code 
CLS#0:select_chantprompts:CALL c,ch 

END DEFine 

DEFine PROCedure select_chan 

CLS#0 

PRINT#O, "WHICH CHANNEL (0 to 9) ? " 

REPeat keypress 

as = INKEYS(-1) 

SELect ON a 

=O TO 9 

ch = at: EXIT keypress 

END SELect 

END REPeat keypress 

END DEFine 

DEFine PROCedure prompts 

CLS#0 

PRINT#0,"CURSOR KEYS TO MOVE ELLIPSE AROUND” 
PRINT#O0,"CTRL+UP/DOWN TO CHANGE SIZE, ALT+UP/DOWN TO CHANGE ECCENTRICITY" 
PRINT#O,"ALT+CTRL+UP/DOWN TO ROTATE ELLIPSE” 
PRINT#O,"SPACE TO DRAW ANOTHER ELLIPSE IN THE SAME WINDOW" 
PRINT#0,"ENTER TO RETURN FROM ROUTINE"; 

END DEFine 
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ARGHIVE YOUR @l 


SOLLECTION 


yee can keep your Sinclair QL quality product, British-made and 


Now 


World magazines safe and.clean: No comes with full binding instructions. It is 
more dog-eared covers or missing manufactured in a rich, deep blue with . 
copies . . . You can protect vote genuine gold blocked lettering. 
magazines in this. high quality, Enhance your Sinclair QL World 
specially-created binder. This Sinclair Magazine collection now for only. . 
QL World binder will comfortably hold $6.95 (inc.P&P!) Send for one today! 
a complete year’s issues of your. The QL World binders also make an. 


favourite Sinclair magazine. It is a high ~ ideal gift for other Sinclair users too! 


ITO: QL WORLD, THE BLUE BARN, WOOTTON, WOODSTOCK, OXON. OX71HA I 
I Please send me (_] QL World binders - | enclose £6.95 for each binder including VAT. postage & packing... I 


| Readers outside the UK and Eire please add £1.95 for surface overseas mail. # A 
| Please make cheques payable to ARCWID LTD. is ED Os ee | 
J ACCESSL]vISAL_Jaccount:| iF | | ‘Expiry date... | 
tees I are 
Sa ee PE ae re eae een Cent one SO Weer hy LAE ee eRe! MiG oy) I 
A a ee eee eee Sip eee a ee See Lene Re een! | 

Ses RE nal area ene POSICOdE sia. cae cvesere eesrienn ees Tel No. TRUE TRE SRST | 
‘oo oo ese ee ee ee ee es ee 
ADVERTISE YOUR SECONDHAND OL | 
I i iF I 
I I 
| EQUIPMENT FREE OF CHARGE. ! 
1 COMPLETE THE FORM BELOW (NO FAX'S OR PHOTOCOPIES ACCEPTED. PRIVATE SALES ONLY) 1 
I I 
NANO) BST 19 Jo suey art of 0. Taupe Please send coupon to: Advertising Department ; 
SMM ranrsica Si fs taonsavbs spear iol Sinclal Ol: Warid: Fhe-Blue Bare Tow- bane 
\ ADDRESS &..2:..00825 SRR, FR Ss set Wootton, Woodstock, Oxon.OX7 1HA. Pleae r 
Jo merceereeceeeetscetnettereteteneetnnerneennettnetneetnantnsetnseeneene place this Classified Advertisement in the next I 
I [DAYTIME TELEPHONE Now issue of Sinclair/QL World. I 
I l 
i l 
I I 
I I 
I | 
I l 
I l 
| I 
I l 
I I 
I I 
I l 
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MICRO ADS 
MICRO ADS 


sive 41 page manual. 


Ol Op “ ELECTRONIC 


QTop The definitive User-Front-End V1.11 SFR 70.-- 
The QL's equivalent to WINDOWS on MS-DOS PC's. The system-manager offers the mainmenus DESK, 
DEVICES, FILES, JOBS, KEYBOARD, PROGRAMS, MY PROGS, TOOLS and OPTIONS with 
over 110 sub-menus. QTop is ideal for Gold-Card or Harddisc users as it supports real Sub-Directories. The 
powerful QJUMP extended Pointer Environment is included and all its facilities are supported. Comprehen- 


ArcED The professional Text-Editor V2.6 SFR 39. 
The Text-Editor especially for programmers. Written in fast, reentrant machine code (only 20KB). 
Comprehensive 29 page manual. 

ExeQtor The Super-QL in a limited edition/ask for quotation. 
We use the QL PCB, GOLDCARD, QIMI & Mouse, JFC K90 & MF-2 Keyboard, up to 3 discdrives and a 


NEW PENMAN PLOTTER upto A2 
featured in Tomorrows World and QL 
World. Software available. £120 DRDOS 
complete with manuals £25.Daul 3.5" 
drives with psu, cable £80. 0449 767130 


QL JS-D16 384k, trump card, daul flp, 
Philips pro 73 monitor Lightning (se). 
spem keyboard centronics GLP2 printer. 
65mdvs 10 disks, books: Jones, 
Dickens, pennel etc. software: turbo, 
assembler, hundreds more. Magazines 
1985 £350 (0320) 51282 


HARD DISK 40 with instructions 
£2500.n.0. Brother HR 20 Daisywheel 
with faulty cut sheet feeder £100 Brother 
HR15 Daisy wheel with working cut sheet 
feeder £100 3 1/2" disk drive £40 


TRUMPCARD2 only 12 months old and 
as new £70 plus postage, Tel 0532 
533368 (Wakefield) 


QL GREEN MONITOR, Gold Card, Real 
time digitizer, twin drives, centronics 
interface, software: Editor, Digitalc 
Special Edition, Lightning, Touch Typist, 
Assembler workbench etc All for £400 
Will split. tel O21 449 8041 


QL JS 128k Twin cumana 3 1/2" DD 
drives, NEC 8" green monitor, Citizen 
120d printer, sage intergrated accounts, 
archivist, original PSION software and 
manuals plus books £150 Stephen 0497 


FOR SALE 40 unused microdrive 
cartridges in two transform boxes £40 
Qjump QL monitor cartridge and manual 
£10 Technology research delta diskdrive/ 
printer interface, 128k Ram, Ram disk 
manual £40 tel: 0732 355341 


USED MDV CARTRIDGES £150 each. 
Need formatting. Add 20p to total for 
every 6 or part 6 for p&p. Allow 14 days. 
Give full address, telephone number and 
postcode. telephone 0751 31648 


640k QL with expanderam, Qflash 
ramdisk Eprom, Printerinterface, PSION 
suite, manuals, books, magazines, 
Qload, The editor, Games, Plus 40 mdv 
cartridges. Make me an offer 051 639 
6736 (merseyside) 


QL ROMS AND SPARES 
ROMS, MGE (Spanish, MGF (French), MGG 
(German), JS (English), £20 each. JM (English), 
£10 

MDVS. Complete QL MDV Subunit £20, head 
and chassis £10, Microswitch £2, Motor £6. 
Rubber & Plastic Roller £2. MDV2 Stand-off 
spacer + srew £2. ULA £5. Tr 4,5,6,7 set £2. 
MDV peb inc, ULA £11. Prices include UK 
postage. Send SAE for price list ofall QL spares. 
Joe Atkinson, 36 Ranelagh Road, Ealing, 
London W5 5RJ (Mail Order Only). 


QL REAL TIME 
DIGITIZER 


Digitize moving pictures in real time. Transforms QL into a 


820152 Video printer or 3-D image digitizer via a video camera/recorder 
* Digitizes in .02 secs 

* 256x256 resolution in 8 levels 

* Full, '/s or 4x '/s screen modes 

* Screen update - 5 or 2.7 frame/sec 


harddisc (option) to build the Super-QL in a Tower case. QTop and ArcED are included on the system disc. 
Ask for free product information. Software is available on 3.5" or 5.25" disc. All our products are compatible 
with all QL compatible computer. Free updates and user-support. Please specify English or German version. 
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Prices including P&P. Send orders with cheques to drawn in SFR to: 


COWO Electronic 


Urs KGnig, Miinsterstrasse 4, CH-6210 Sursee, Tel 045-211478 


or contact TK Computerware (UK) and QLympic Computer Systems (Germany) 


* 4:1 grey level 9-pin printer dump. 

* Interfaces to QL ROM PORT 

* Runs on unexpanded QL and multitasks. 

* P&P 3.00 UK, 9.00 overseas, state MDV or FLP 

CL SYSTEMS, 403 CHAPTER ROAD, DOLLIS HILL 
LONDON NW2 5NG TEL: 081 459 1351 


a eg er eee ee ee 


GLASSIFIED 


Please send coupon to: Advertising Department Sinclair/QL World, The Blue Barn, Wootton,Woodstock, 
Oxon. OX7 IHA. Pleae place this Classified Advertisement in the next issue of Sinclair/QL World. 


| enclose a cheque/P.O. to the value of £17.65 (inc. 
VAT) for a lineage advertisement of no more than 30 
words. Please make cheques payable to: 


Arewind Ltd 


Bees ae ae ee ae ss ee ee el ee 
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SGV OdDIN *** SGV OFDIN *** SAV OJIN *** SAV OYDIN **" SGV OHDIN *** SGV OYDIN *** SGV OHDIN '** Sav OYDIN *** Sav OYDIN 


NEW THIS MONTH 


PRINTMASTER, SOLITAIRE, EASYPTR, 
DISA, REMIND-ME PLUS, DBEASY, 
DBPROGS - SEE SOFTWARE LISTS ON 
THESE TWO PAGES. 


CATALOGUE 


PLEASE ASK FOR A COPY OF OUR QL SOFTWARE 
CATALOGUE. WE NOW SELL SO MANY ITEMS 
THAT WE CANNOT PROVIDE MUCH DETAIL IN 

THE ADVERT, THE CATALOGUE CONTAINS MORE 
DETAILS OF THE PROGRAMS AND A SAMPLE 

SCREEN PRINTOUT FROM MOST OF THEM 


WE WILL BE EXHIBITING AT QUANTA 
WORKSHOPS IN LONDON (30TH MAY) AND 
NEWCASTLE-UPON-TYNE (28TH JUNE) 
AND WOULD LOVE TO SEE YOU THERE! 


SOFTWARE DISCOUNTS 


BUY 2 PROGRAMS TOGETHER 
CLAIM 5% OFF 


BUY 3 OR MORE PROGRAMS 
CLAIM 10% OFF 


LABELS 
MICRODRIVE LABELS roll of 100 £2.00 
DISK LABELS roll of 100 . £2.00 
100 DISK LABELS on printer roll £2.50 
100 ADDRESS LABELS on printer roll £2.00 
Please add £0.50 postage per roll of labels (max 
postage £2.50) if only ordering labels. 


FLOPPY DISKS 

3.5"DSDD UNBRANDED DISKS 

20 OR MORE UNBRANDED DISKS...... £0.40 
3.5" DSDD SONY BRANDED PACK OF 10.. £9.00 
3.5" DSHD HIGH DENSITY DISKS : 
5.25" DSDD UNBRANDED DISKS £0.45 
MICRODRIVE CARTRIDGES - please phone to ask 
about price and availability before ordering. 
POSTAGE RATES - SEE BELOW. NO NEED TO ADD 
POSTAGE ON MICRODRIVE CARTRIDGES 


DISK STORAGE BOXES 
POSSO BOXES, drawer style, holds 150 or more 
3.5" disks. Stackable disk storage system, in black, 
like a QL 

Plastic case, holds 80 3.5" disks 

Plastic case, holds 40 3.5" disks 

(both above boxes have clear, lockable lids and a 
small set of disk dividers) 

Small case for 10 3.5" disks 

POSTAGE RATES - SEE BELOW 


STANDS 
MONITOR STAND, TILT/SWIVELACTIONS, HOLDS MONITORS 
WITH UP TO 14" SCREENS 
PRINTER STAND, 80 COLUMN PRINTERS 
POSTAGE RATES - SEE BELOW 


Dilwyn Jones Computing 


41 Bro Emrys, Tal-y-Bont, 
Bangor, Gwynedd LL57 3YT U.K. 
Tel: Bangor (0248) 354023 


QL SOFTWARE 


B MEANING OF CODES IN SQUARE BRACKETS BELOW 
R] RAMDISK REQUIRED 
F] AVAILABLE ON FLOPPY DISK 
1M/2M] AVAILABLE ON MICRODRIVE & NUMBER 

OF CARTRIDGES REQUIRED 
128/512K] MINIMUM MEMORY REQUIRED 
PRICES OF SOFTWARE AVAILABLE ON MICRODRVIE 
HAVE NOW BEEN SIMPLIFIED. PLEASE ADD £2.00 TO 
THE PRICE SHOWN BELOW TO COVER THE EXTRA 
COST OF THE MICRODRIVE CARTRIDGE(S) AND 
DUPLICATION, OR ENCLOSE YOUR OWN 
CARTRIDGE(S) WITH THE ORDER AND PAY THE 
PRICE SHOWN. 


FILE TRANSFER 


DISCOVER 

[F 256K] Copy files from QDOS to PC disks and 
vice versa. No cables required! 
MULTI-DISCOVER 

[F 256K] Enhanced version, also featuring trans- 
fer between QDOS and BBC micro DFS/ADFS; 
CPM and UNIX CP10 disk formats. 

TEXTIDY 

[F 256K] Strip out control codes from Quill text 
files etc and assist Discover with text file conver- 
sion to other computers. 


LEISURE 


SOLITAIRE 

[F 2M 128K] NEW! A very addictive Patience card 
game, sometimes also known as Klondike, for one 
person. Las Vegas rules option! Great fun and very 
addictive - not a lot of work was done when this one 
arrived! 

CRICKET SECRETARY i 

F 2M 128K] Record, display and print CRICKET 
AVERAGES, etc - all the traditional features of batting 
and bowling averages, "how out" analysis, best 
bowling, runs per over and bowls per wicket. Useful 
or cricket club secretaries and fun for all cricket buffs 
who'd like to keep a record of how their heroes have 
ared! 


QUESTION MASTER 

F 2M 128K] Question and multiple choice answers a 
program - use for revision or just for entertainment. 
QUESTION SET 1: GENERAL KNOWLEDGE... £5.00 
QUESTION SET 2: CLASSICAL MUSIC 

QUESTION SET 3: OL-ESTIONS 

(ALL 3 SETS WORK IN 128K OR MORE MEMORY 
WITH QUESTION MASTER PROGRAM) 


FLEET TACTICAL COMMAND II £49.95 
F512K] Naval strategy game, playable on one or two 
networked computers. Ask about the information 
booklet for this superb game. 


FTC DATA PRINT UTILITY 
F 512K] Add-on for FTC II described above. 


THE FUGITIVE 
F 512K] Text adventure game. 


COCKTAILS WAITER 

F 256K] Database of hu s s of recipes for alco- 
holic drinks. Useful for hotels and bars, or just for 
entertainment at home. 

View, search, select, print, etc. recipes. 

MIX 2 RECIPES FOR C.W 

MIX 3 RECIPES FOR C.W Hi 
(BOTH WORK IN 256K OR MORE MEMORY WITH 
THE COCKTAILS WAITER PROGRAM, 100'S OF 
RECIPES) 


PROGRAMMING 


EASYPTR II 

[F 256K] VEW! Albin Hessler's development system 
for pointer environment programming. Assists 
greatly with writing menu's, etc. 

EASYPTR BUDGET VERSION 

DISA DISASSEMBLER 

[F 256K] NEW! Interactive machine code 
disassembler program, runs in pointer environment, 
reviewed in QL World April 1992. 

BASIC REPORTER . 
[F 1M 128K] List variable names, keywords, proce- 
dures, etc. Useful for BASIC programmers. 


BUDGET QLIBERATOR COMPILER £25.00 
[F 1M 128K] Version of the QLiberator SuperBASIC 
compiler for unexpanded QL's. 


QLIBERATOR BASIC COMPILER £50.00 
[F 256K] A full QL SuperBASIC compiler with even 
more features than budget version! 


QLOAD & OREF UTILITIES 

[F 1M 128K] QLOAD is a fast load utility for BASIC 
programs. QREF is a cross referencer for listing 
names used in BASIC programs. 


FILE HANDLING 


FILES 2 i 
[F 1M 128K] Simple to use popup file handling utility 
for viewing, copying, deleting, renaming etc files. 


FILEMASTER F 

[F 1M R 512K] For bulk copying, deleting, etc of files 
quickly via ramdisk, also does simple disk labelling 
& files list printout. 


THE GOPHER f 

[F 1M 128K] Searches for and tells you which files 
contain a given text string, e.g. ask it to find letters 
referring to Mr Jones 


WINBACK : 
[F 256K] Hard disk backup program for Miracle hard 
disk and compatibles. Version 2 now available (able 
to split large files onto several disks, etc.) - return 
version 1 master disk with £3.00 for upgrade. 


DISPLAY SOFTWARE 


VISION MIXER 1 

[F 2M 384K[ Screen display software, use for an 
eye-catching display of QL mode 4 or mode 8 screens 
e.g. for advertising. New version 1.5 now available 
with builtin speed control. Return master master dis 
with £3.00 for upgrade. 

VISION MIXER PLUS 

[F 384K] Enhanced version, but even easier to use| 
Now menu driven, with new effects and greate 
capabilities. 

PICTUREMASTER 

[F 256K] Screen maker for use with Vision Mixers, o 
can also be used as a simple to operate graphicg 
program. 

PICTUREMASTER PLUS 

[F 384K] Enhanced version, with additional features} 


UPGRADE TO PICTUREMASTER PLUS ..... £5.00 


NEW QL SOFTWARE 


THE MEGA TOOL KIT £25.00 
version on EPROM..£40.00 


(F 1M 128k) A superb new toolkit of over 200 
SuperBASIC extensions. Ideal for use in BASIC 
programs and in compiled BASIC programs too- 
there is even a runtime version which can be used 
in compiled commercial or public domain programs 
free of royalty payment! Comprehensive manual 
and large file of demonstration routines! If you buy 


the EPROM version, you get the disk version too! 


(F 512k) A program for making large text banners, 
up to four pages long! Prints sideways, using outline 
fonts for greatly improved quality of printing (banish 
those horrible jagged edges!). Ideal program for 
making signs for shows, small businesses, adverts, 
and so on. Currently only suitable for 9 pin Epson 
compatible printers, other versions being written, 


please enquire! 


(F 384k) A really simple to use menu driven editor. 
Can be used for editing plain text files, binary files, 
creating source files for asemblers and so on-even 
to edit SuperBASIC programs, in fact any 
application where an easy to use editor is more 
useful than a word processor. Features include full 
block handling, searc h and replace, word wrap, 
margins, can use Toolkit 2 default device, dynamic 
linked list memory handling, configurable with 
CONFIG, many features! 


OPD TRANSFER ....£15.00 


Software to allow the transfer of files between the 
QL and the microdrives on OPD and Tonto 
computers, written by the author of Discover and 


Textidy. 

NEW! PC VERSION OF 
FLEET TACTIVAL 
COMMAND II £69.95 
QL+PC versions pack £85.00 
Upgrade-contact us! 


Compatible with the QL version, but with improved 
graphics. Can be networked to a QL version by 
means of a QL to PC serial lead (wiring diagram 
included). If you enjoyed playing the QL version and 
also have a PC, you can now enjoy playing this on a 
PC as well! 


FILE HANDLING 


THE SMALL PRINT! POSTAGE AND PACKING CHARGES: Software is sent post-free to UK addresses. To other countries, please add £1.00 per program for postage and packing. 
PRICES: All prices are shown in UK Pounds Sterling. PAYMENT: We can accept payment by cheque (in UK Pounds Sterling currency only, please, drawn on UK branch of a bank or 
building society),Eurocheque, Postal Order, or by these credit cards: VISA, ACCESS, MASTERCARD, EUROCARD and by CONNECT card. Please st ate the card type, number, 


Dilwyn 


41 Bro Emrys, 


Jones 


Computing 


Tal-y-Bont, 


Bangor, Gwynedd LL57 3YT U.K. 
Tel: Bangor (0248) 354023 


PROGRAMMING 
EASYPTR Il 
Budget EasyPtr 4 
DISA disassembler ....£29.00 
BASIC REPORTER ...£10.00 
QLIBERATOR : 
BUDGET VERSION...£25.00 
QLOAD & QREF 


GRAPHICS 
THE PAINTER 


QRACTAL SCREENS .£5.00 
IMAGE PROCESSOR £15.00 
Version 1 upgrade 

PD2 CLIPART h 
SCREEN SNATCHER£10.00 
TEXT 'N'GRAPHIX ....£20.00 


TRANS24 


PAGE DESIGNER 2+ £40.00 
NB Delayed-please check if 

available yet before ordering. 
UPGRADE PD2 TO PD2 PLUS ....£20.00 


TEXT 
BIBLE TEXT DISKS, PLAIN 
TEXT FORMAT 
QUILL_DOC FILES ...£20.00 
SPELLBOUND : 
SPELLBOUND S.E. ...£50.00 
Upgrade to SE version £30.00 
QUICK POSTERS 
ROB ROY PACK 


FILE TRANSFER 
DISCOVER sctsccscerss £20.00 


DATABASE 
ADDRESS BOOK & LABEL 


DATA DESIGN : 
FLASHBACK S.E.......£40.00 
QL GENEALOGIST ...£12.00 


LEISURE SOFTWARE 
SOLITAIRE : 
CRICKET SECRETARY £12.00 
QUESTION MASTER £10.00 
QL FLEET TACTICAL 
COMMAND 1! 


OTHER QL SOFTWARE 
PRINTMASTER 
HOME BUDGET 
REMIND-ME 3 
REMIND-ME PLUS ...£20.00 
SCREEN ECONOMISER 


DISPLAY SOFTWARE 
VISION MIXER 1 : 
VISION MIXER PLUS £22.50 
PICTUREMASTER ....£15.00 
PICTUREMASTER +.£20.00 


HARDWARE 
MINI PROCESS 


CONTROLLER .....1.... £59.95 
MPC TOOLKIT software £9.95 
NETWORK PROVER ..£3.50 


expiry date, your address and sign orders sent by post. We can also accept orders paid by credit card by telephone. There is an answering maching for when | cannot answer in 
y ie} 


person, so that | can call you back later. Goods remain the property of DJC until paid for in full. PLEASE STQATE IF YOU REQUIRE 3.5 OR 5.25 INCH DISKS OR ON 
MICRODRIVE CARTRIDGE (ADD £1 PER PROGRAM ON MICRODRIVE CARTRIDGE TO COVER HIGHER COSTS OF SUPPLYING SOFTWARE ON MICRODRIVE). 


p-asiiabanaiaiiienn 


